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| DISCLAIMER 


DISCLAIMER ON CONTENTS 


The following should be read and understood before purchasing 
and/or using this Interface Standard/Design Guide. 


The technical information contained in this document is accurate, 
to the best of the knowledge of the author and the reviewers. 
However, given the volatile nature of the computer and electronics 
industry, along with the lack of access to original design 
documentation on the 99/4А system, there is no warranty that the 
contents of this manual will be free from error or will meet the 
specific requirements of the purchaser. The purchaser assumes 
complete responsibility for any decision made or actions taken based 
on information obtained using the contents of this manual. Any 
Statements made concerning the utility of the contents are not 
construed as expressed or implied warranties. 


The author reserves the right to revise any of the contents at 
any time without notice. However, registered owners will be notified 
if significant revisions or additions to the contents are made. 
Purchasers are encouraged to notify the author of any errors found in 
the text or graphics. 


The author makes no warranty, either expressed or implied, 
including but not limited to any implied warranties of fitness, 
operability, or validation of design, regarding the contents or any 
information derived therefrom, and makes all contents available solely 
on an "as is" basis. 


In no event shall the author or the reviewers be liable to anyone 
for special, collateral, incidental, ог consequential damages in 
connection with or arising out of the purchase or use of this 
literature and the sole and exclusive liability of the author, 
regardless of the form of the action, shall not exceed the purchase 
price of this manual. Moreover, the author shall not be liable for 
any claim of any kind whatsoever by any other party against the user 
of this manual. 


Texas Instruments did not contribute to, commission, nor approve 
the creation of the Interface Standard/Design Guide. А11 information 
used in deriving the contents of this manual are available in the 
public domain. "TI", "TI 99/4A", and "99/4A" are registered 
trademarks of Texas Instruments. 
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NOTICE OF FEGISTRATION 


NOTICE OF USER REGISTRATION 


Each copy of this document has a unique identification number 
assigned to it, which is printed on an adhesive label and attached to 
the manual cover. The Purchaser must forward а postcard or letter 
listing his/her name, address, and document ID number to the address 
given below. The Purchaser then becomes the only authorized User of 
the manual. ΑΙ] inquiries made to the author by the User must include 
the ID number of the manual; inquiries without the User's name and 
manual ID number will not receive a response. Registered Users will 
receive notices of future significant revisions to the manual as they 
are released by the author. А11 readers of the manual are strongly 
encouraged to provide comments, criticisms, or input on errors 
concerning the manual directly to the author: 


E Lewis 


REFERENCES 


REFERENCES 
The following sources were used as references for this manual: 
1. Microprocessors/Microcomputers System Design, Texas Instruments, 
McGraw-Hill Book Company, 1980. QA76.S.T49. ISBN 0-07-0637558-X. 


2. 16 Bit Microprocessor Systems, Texas Instruments, McGraw-Hill Book 
Company, 1982. TK7895.M5.C35. ISBN 0-07-063760-1. 


3. TI 99/4A Console and Peripheral Expansion System Technical Data, 
Texas Instruments, 1983. 


4. Hardware Manual for the TI 99/4A Home Computer, Micheal Bunyard, 
PE, 1986. 


5. TMS9900 Data Manual, Texas Instruments, 1985. 


6. TTL Cookbook, Don Lancaster, Howard Sams Co., 1974. ISBN 
0-672-21035-5. 


7. TI 99/4A Peripheral Schematics: RS232-1039308; Memory Expansion- 
1039330, Disk Controller-1039340. 


8. Software Development Handbook, 2nd Edition, Texas Instruments, 
1981. ISBN 0-904047-31-8. 


9. TI 99/4A INTERN, Heiner Martin, Verlag fur Technik und Handwerk 
GmbH, 1985. ISBN 3-88180-009-3. 


10. Explorer Technical Manual, Millers Graphics, 1985. 

11. DiskAssembler Technical Manual, Millers Graphics, 1986. 

12. PEB ProtoBoard Manual, Scott Coleman and John Willforth, 1988. 
13. Technical Drive, Monty Schmidt, 1987. 

14. Editor/Assembler Manual, Texas Instruments, 1982. 


15. Texas Instruments Graphics Programming Language User's Guide, 
Personal Computer Division, Texas Instruments, Dec. 1979. 


16. Horizon RAMDisk Source Code and Technical Manual, Horizon 
Computer Limited, 1986. 


S&E παπα NM M MN κα σα αν αμα M M gg M 


RESOURCES 


RESOURCES 


This document was created on TIWriter Version 4.2, by R. A. Green 
Software. Graphics were created with AutoSketch 2.0. 


Disassembly of existing console and DSR code was accomplished via 
Millers Graphics EXPLORER and DISKASSEMBLER programs. The program 
"GPLDIS" was used to disassemble the GPL code in GROMs 0-2. Reference 
9 provided input on console routines. References 9, 10, and 14 were 
used to compile information on use of console RAM locations as they 
pertain to DSRs. 


References 1, 2, 4, and 5 provide information on the TMS9900 
microprocessor and related system design. References 1, 8 and 14 are 
excellent sources on assembly programming. Reference 13 provides 
completely disassembled and commented DSR codes for several 
peripherals. Reference 15 provides information on the Graphics 
Programming Language, which was useful in disassembling code in GROMs 
0-2. 


All references listed are recommended as excellent sources of 
information for the 99/4A and its Peripheral Expansion System, and the 
reader is encouraged to consult them for more information. Where 
possible, consult with the local library about obtaining references 
via the InterLibrary Loan System, using the ISBN number. Below is a 
list of current addresses for some of the references: 


Millers Graphics 
1475 M. Cypress Ave. 
San Dimas, CA 91773 


Texas Instruments Inc. 
Data Book Marketing 

PO Box 117692 

Carrollton, TX 75011-7692 
(800) 232-3200 


The Bunyard Group 
PO Box 62323 
Colorado Springs, CO 80962-2323 


LL Conners Enterprises 
Computer and Electronics 
1521 Ferry Street 
Lafayette, IN 47904 


Readers interested in obtaining copies of Technical Data and the 
GPL manual may contact the author directly for more information. 


UTILITY PROGRAM COMMENTS ] 


UTILITY PROGRAMS 


A 5-1/4" single sided, single density diskette containing utility 
programs is provided with the manual to assist the peripheral 
developer in creating DSRs and application programs. The purpose of 
including these programs with the manual is to provide (in the 
author's opinion) the "best" utility programs available to the 
developer such that DSRs may be quickly written, debugged and 
released. Disassemblers are also included for reverse engineering 
console/peripheral code as needed to insure compatibility. [Use of 
Millers Graphics DISKASSEMBLER for disassembly is highly recommended; 
DISKASSEMBLER is available from several sources.] 


Each of the programs took several days of development by their 
authors to complete. Responsible purchasers are obligated to forward 
a contribution to the software authors to acknowledge the usefulness 
of their products, and to encourage development of future products. 

HOTBUG is not fairware; consult the documentation for proper 
registration of ownership. The README file on the disk contains a 
list of the utility programs, program description, recommended 
contribution amount, author name and current address. 
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| INTRODUCTION 


INTRODUCTION 


The purpose of this manual is to consolidate all information 
available in the public domain on the design and development of 
peripherals for the TI 99/4A computer into one reference. There are 
several excellent documents on the hardware and software of the 
console and its peripheral system available; however, this manual has 
been specifically written for designer/developers who wish to create 
new hardware and/or software for TI 99/4A peripherals. 

The manual is an intermediate level text in that it is assumed 
that the reader is familiar with the TMS9900, its assembly language, 
the 99/4A peripheral system, the File Management System, and general 
computer апа electronics concepts. Readers who аге novices іп any of 
these areas should consult the appropriate references before using 
this manual. Although some overlap of information exists between this 
manual and the references, the reader is urged to consult the 
references as needed for information not included in the Interface 
Standard/Design Guide. 

As the title implies, this manual is meant to provide a 
consistent basis, ог standard, for designers to create peripherals 
that will be compatible not only with the TI 99/4A, but with other 
peripherals as well. Basic information on hardware and software 
techniques is also provided for use by the developer. 

Sections A-H cover the hardware aspects of the console and 
peripherals, and includes design information on chips and circuits. 
New peripheral types are defined in Section C, and existing peripheral 
locations are assigned in Section G. Section I covers the basics of 
Device Service Routine (DSR) construction. Section J discusses how 
the routines built into the console access peripherals and their DSRs. 
Where ever possible, examples are given of hardware and software 
concepts to assist the reader. 

The author hopes that all readers will find the Interface 
Standard/Design Guide useful and informative. The author would also 
like to thank the following people who reviewed and commented on the 
original draft of the manual: 


John Willforth Mike Dodd 


Matt Beebe Barry Boone 
Jim Reiss Mid-Atlantic 99ers 
Peter Hoddie John Johnson 


Paul Carlton 
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SECTION A: 9900 SIGNALS/INTERFACING 


1.0 Introduction 


The TMS9900 microprocessor has 64 pins, 49 of which are used as 
signals to communicate with other chips and the outside world. These 
signals can be grouped into two basic sets, or buses: memory bus and 
CRU bus. The memory bus can be further divided into three types of 
signals: address, data, and control. This section will briefly 
discuss the function of the TMS9900 signals, and how they are used and 
modified by the /4A system. References 1, 2, and 5 contain more 
detailed descriptions of the 9900 signals. 


2.0 Memory Bus 


The memory bus is used to communicate with memory chips (or 
memory mapped devices) by selecting an address, then reading or 
writing data to or from the address. The address bus provides signals 
to select individual addresses, while the data bus provides ἃ two way 
communication path for information to travel. The control bus signals 
coordinate action between the microprocessor and other devices. Below 
is a brief description of the functions of the memory bus. 


2.1 Address Bus (A0-A14) 


The 9900 has 15 address signals, AO - A14, with AO the most 
significant bit (MSB). These signals are driven out of the micro, and 
are used to select the address of information to be read or written. 
It is assumed that the memory system will have a 16 bit word design, 
and not a byte (8 bits) wide data bus, because the 9900 addresses 32K 
words (16 bits) for each read or write function. Тһе 9900 cannot 
address individual bytes because there is no А15 signal to 
discriminate between even and odd bytes. To perform byte reads, the 
9900 will read two bytes simultaneously, discarding the information in 
the unused byte. To perform byte writes, the 9900 first reads two 
bytes, alters the byte being written to, and then writes both bytes 
back to memory. 


2.2 Data Bus (00-015) 


The data bus is 16 bidirectional signal lines used to read or 
write information from other devices. Since the data bus is 16 bits 
wide instead of eight, the 9900 can access twice as much information 
per unit of time than a similar micro with an 8 bit data bus. 


2.3 Control Signals (DBIN, -WE, etc.) 


Control signals are used to synchronize the operations of the 
9900 with the devices that it is communicating with. The 9900 control 
signals are summerized below; consult Reference Ί or 5 for more detail 


[SECTION А: 9900 SIGNALS /INTERFACING PG А2 


оп these signals. 


in 
1/0 /4A? Signal Description 

0 Y ΞΜΕΜΕΝ used to enable memory accesses, differentiates 
between memory bus and CRU bus activity 

0 Y DBIN data bus direction, determines the direction of 
data (in or out) for the 9900 

0 Y -WE write enable, denotes writes to memory 

0 Y IAQ Instruction Acquisition Status, denotes that 
the microprocessor is obtaining an 
instruction from memory 

I Y READY memory ready status, informs micro that 
system memory is ready to be accessed. 

0 N WAIT Ready acknowledge, status signal that 9900 


acknowledges memory not ready to be accessed. 
I N -HOLD HOLD process, when active, puts 9900 signals 
in inactive state. Memory bus may now be 
driven by another device. 
0 Y HOLDA HOLD Acknowledge, informs external device that 
9900 acknowledges receipt of HOLD request. 
I Y -RESET Reset input, resets micro to initial state 
Y -LOAD nonmaskable interrupt, forces 9900 to branch 
to address >FFFC for new program counter and 
workspace values 
I N ICO-IC3 interrupt code 0-3, inputs for up to 16 
maskable interrupts 
I Y -INTREQ Interrupt Request, informs 9900 that an 
interrupt code is valid on ICO - IC3 


{signals may be either available externally, or used only internally 
by the console; signals may be altered or unused in current design] 


3.0 CRU Bus 


The input/output bus on the 9900 is known as the Communication 
Register Unit (CRU) bus. Тһе CRU bus is similar in concept to the 
memory bus, with the following exceptions: 


1: The memory bus can communicate іп words (16 bits) with a set 
of odd and even addresses. The CRU bus associates one bit per address 
accessed by the 9900. 

2: The CRU address space is limited to >0000 to >1FFF, where as 
the memory bus can address >0000 to >FFFF. These are separate and 
distinct addresses; control signals are used to differentiate between 
memory address space and CRU address space. 

3: Тһе CRU bus is used primarily to control peripherals (on/off) 
versus communication of data because the memory bus transfers more 
bits per access than the CRU bus. 

4: The CRU bus does not have as many control signals as the 
memory bus, sometimes causing design concerns when developing 


) 
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circuitry. 


The CRU bus consists of the following signals, all of which are 
used in the /4A system: 

A3-A14 (out) These lower order address lines define the CRU space 
20000 to >1FFF. Same lines as used by memory bus. 

CRUCLK (out) CRU Clock, used during CRU output to inform external 
device that address bus and CRUOUT output bit signals 
are stable. 

CRUOUT (out) CRU Output Data, outputs value of bit when CRUCLK 
is active. 

CRUIN (in) CRU Input Data, inputs bit value into 9900 


References 1 and 2 have excellent discussions of the CRU bus as 
implemented by the 9900. 


4.0 Interfacing with the /4A 


The signals available for the 9900 are used іп various 
combinations to allow it to interface to external devices. This 
section will cover the relationships between the signals on the memory 
and CRU buses as they are presented to peripheral devices by the /ДА 
system. Not all 9900 signals are available in the /4A system for use 
with peripherals; likewise, the relationship and timing of some 
signals are radically modified by the /4A system and do not conform to 
the original 9900 signal format. Most notable is the fact that the 
/4Α system has an 8 bit peripheral data bus, not 16 bits. 


4.1 Memory Bus Interfacing 


The /4A system will read an odd and even byte within a word 
boundary by reading the odd byte first, then the even one. Control 
logic circuitry internal to the /4A allows it to read the first byte, 
then the second, and then reassembles them into a word before 
presenting it to the 9900. Figure A.1 shows the appropriate signa! 
timing and relationships. 

The control logic is: 


IF -MEMEN is low AND DBIN is high, THEN a memory READ is 
occuring. 


There is no need to include -WE in decoding for a Read. The /4A 
system automatically inserts two wait states (333 ns each) for each 
byte access. Allowing for 100 ns settling time for the address lines 
to become valid after -MEMEN goes low, a peripheral has up to 650 ns 
to provide valid data on the data bus. 

A0-A14 аге held constant per memory read - - - only A15 changes 
state during a memory access for a Read. А15 is generated by the /4A 
system to differentiate between odd and even bytes, and is not 
produced by the 9900. 
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The /4Α system writes information to an odd and even byte within 
a word boundary with timing similar to a Read operation. Figure A.2 
shows signal timing and relationships for a wWrite operation. The 
control signal logic is: 


IF -MEMEN is low AND DBIN is low, THEN a memory Write is 
occuring. 


Data оп 00-07 is valid when -WE goes low. 

Data is presented on the data bus and is valid (-WE goes low) 
approximately 333 ns after -MEMEN and DBIN аге ^oth low; -WE remains 
low for 578 ns, typically. One -МЕ pulse is generated per byte Write, 
whereas the 9900 generates only one -WE pulse per word. Recall also 
that the 9900 always performs a Read operation to a word boundary 
prior to a Write operation; this is true of the /4A system also (ie- 
the /4A reads two consecutive bytes, even when performing a single 
byte write operation). 


4.2 CRU Bus Interfacing 


Input and output on the CRU bus is more simplistic but also can 
create problems for designers if certain relationships are ignored. 
The CRUCLK signal of the 9900 is inverted by the /4A system to produce 
-CRUCLK. This is used to strobe а CRU bit out of the /4A via the 
CRUOUT line, similar to the way -WE strobes data from the D0-D7 lines. 
The timing relationship fo a CRU output series is shown in Figure A.3. 
The control signal logic is: 


IF -МЕМЕМ is high AND -CRUCLK is low THEN a CRU bit is output on 
CRUOUT. 


The -MEMEN signal allows the /4A to multiplex the A15 and CRUOUT 
on the same pin; the pin is for "А15" if -MEMEN 15 low, and for 
"CRUOUT" if -MEMEN is high. 

Input on the CRU bus is accomplished by establishing a valid 
address оп А0-А15, then reading the bit value on the CRUIN line 400 ns 
after the address is valid. 

No other control signals are needed to define a CRU Read 
operation. Unlike the memory bus operation, external devices have no 
warning that an operation on the CRU bus is about to occur (-MEMEN 
going low notifies the system that a memory bus is going active; there 
is no corresponding "-CRUEN" signal). Designers of peripherals 
utilizing the CRU bus must be aware of this restriction. 
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SECTION B: CONSOLE (44 PIN) AND PBOX (60 PIN) CONNECTORS 


1.0 Introduction 


Not all of the signals from the 9900 are made available to the 
outside peripherals. The side connector on the console has 44 pins, 
38 of which are signals (the rest are power and ground pins). The 
PBox bus has a 60 pin connector, which has 12 power and ground pins, 7 
unused (currently) signals, and 41 active signals. The signals for 
the console and PBox are listed below, along with comments of their 
intended functions. Figures B.1 and B.2 show the console and PBox 
connectors as viewed looking into the connector. 


2.0 Console 44 Pin Connector 
The side connector on the console is an edgecard type with 44 


pins spaced 0.10" pin to pin spacing. The signals, functions and pin 
numbers are as follows: 


Signal Pin 1/0 Comments 

AO (Мв) 31 ^O Address bus signals 

A1 30 0 Ы 

А2 20 0 " 

A3 10 ο п 

A4 7 0 Н 

А5 5 0 " 

Аб 29 0 M 

А? 17 0 ч 

А8 14 O " 

A9 18 O " 

A10 6 0 " 

А11 8 0 x 

A12 11 0 Ы 

А13 15 0 " 

А14 16 O н 

А15/ 19 0 А15 is created by logic internal to the 

CRUOUT console, not by the CPU. CRUOUT is gated 
A15, and is not active unless -MEMEN is 
high. 

DO 37 1/0 Bidirectional data bus 

D1 40 I/0 " 

02 39 1/0 " 

D3 42 I/0 h 

D4 35 I/O i 

D5 38 1/0 н 

D6 36 1/0 " 

D7 34  I/0 n 


Signal Pin 1/0 Comments 

-MEMEN 32 0 Same as for 9900 

DBIN 9 0 " 

-WE 26 0 This is highly modified from the original 


9900 signal into two active low -WE signals 
per cycle (one per byte) 

-MBE 28 0 Memory Block Enable. Created by console 
logic; device enable signal for the 24000- 
»5FFF memory block. Convenient for side 
mounted peripherals. Signal not transmitted 


to PBox bus. 
-CRUCLK 22 0 Phase 3 clock, inverted 
CRUIN 33 | Same as for 9900 
READY 12 I " ", with pull up resistor 
IAQ 41 0 Not transmitted to РВох bus 
-LOAD 13 I H 
-RESET з 0 This is output, and cannot be used to 


input a -RESET signal 

-EXT INT 4 1 External Interrupt, active low, used by 
peripherals to indicate an interrupt 
request to the 9900 


-PH 3 24 0 Phase 3 of the 9900 4 phase clock, 
inverted to active low. 

SBE 2 0 Speech Block Enable; indicates access to 
Speech memory at »9000/»9400 

AUDIO IN 44 I Input for audio from speech module to sound 
chip 

+5V 1 Supply voltage for speech module 

-5V 43 " 


*Not connected to PBox or interface cable. 
DO NOT use for side peripherals, or damage 
to console power supply may occur.* 

GROUND 21,23,25,27 Ground 


3.0 PBox Bus Signals - 60 Pin Connector 


The PBox bus uses 60 pin female connectors with pins spaced 0.10" 
pin to pin spacing. Not all of the signals available from the 44 pin 
connector are available in the PBox bus. The Interface Card sold with 
the PBox determines which signals were transferred. The PBox end of 
the cable also holds some (currently) unused signals high, by tieing 
them to a 5V source via a resistor. The signals, functions, and pin 
numbers are as follows: 
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Signal Pin I/0* 
АО.А 43 I 
А1.А 44 І 
А2.2 4 I 
A3.A 4 I 
A4.A 3 I 
A5.A 40 I 
A6.A 37 | 
A7.A 38 1 
A8.A 3 I 
A9.A 36 I 
А10.А 3 I 
А11.А 34 1 
А12.А 31 I 
А13.А 32 1 
А14.А 29 I 
А15/ 30 | 
CRUOUT.A 

АМА.А 46 HIGH 
АМВ.А 45 HIGH 
АМС.А 48 HIGH 
ро 28 1/0 
D1 25 1/0 
D2 26 1/0 
D3 23 1/0 
D4 24 1/0 
D5 21 1/0 
D6 22 1/0 
07 19 1/0 
-МЕМЕМ.А 56 1 
DBIN.A 52 I 
-WE.A 54 | 
-CRUCLK.A 51 I 
CRUIN 55 0 
READY.A 4 0 
IAQHA 14 М/С 
-LOAD 18 М/С 
-RESET 6 I 
-INTA 17 0 
-CLKOUT 50 1 
AUDIO 10 0 
SCLK 8 N/C 
-LCP 9 N/C 
PCBEN 12 HIGH 
-HOLD 13 М/С 


Comments 


Address bus signals; "A" suffix denotes 


PBox signal 


Extended address bit, held high by interface 
card 


Data bus signals 


IAQ and Hold Acknowledge gated together. For 
use with 9995 based machines as Hold Ack. 
Not used with /4A 


-EXT INT 
-PH 3 


System clock. Use is not defined with /4A 

9995 indicator. Low=9995 machine, high=/4A. 
Possible use to switch peripherals to faster 
speed. 

Enables cards in PBox. Low disables ali cards. 
Active low HOLD request for 9995 based machines 
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Signal Pin 1/0* Comments 

-SENILA 15 HIGH Interrupt level A and B Sense Enable. Allows 

-SENILB 16 HIGH computer to quickly identify peripheral 
interrupt. Not used by /4A system. 

-RBDENA 11 0 Active low remote data bus driver enable line. 


Each peripheral that utilizes the DATA bus 
must generate an -RDBENA signal when accessing 
the data bus. This signal enables the LS245 
transciever in the console end of interface 


card. 
GROUND 3,5,7,20,27 Ground 
47,49,53 
UNREG 8V 1,2 Used to supply unregulated voltages to voltage 
UNREG -16V 57,58 regulators mounted on peripheral cards. 
UNREG +16V 59,60 


[*Either input into the PBox bus, or output to the console] 


4.0 General Notes 


4.1 The interface cable shares a common ground between the 
console and PBox. Positive and negative voltages are not 
interconnected between the PBox and the 44 pin console connector. 


4.2 -RBDENA is not needed for peripherals that do not use the 
data bus (00-07). If used, it should be active low with the chip 
enable signal for the data bus transciever for the peripheral. 


4.3 Unregulated +8V, +16V, and -16V sources are provided to allow 
for voltage regulators (as needed) on each peripheral card. Temporary 
voltage transients on an individual card will not affect the other 
peripheral cards. 


4.4 Signals held high (+5V) by the Interface Card cannot be used 
unless the Interface Card is removed, modified or replaced with a 
different interface card. 


wu. и 


a8 ERA | 
| ο P S K K ο. | 


SECTION B: CONSOLE/PBOX CONNECTORS 


FIG. B.1: 44 FIN SIDE EDGEBOARD CONNECTOR 
(VIEW LOOKING INTO CONSOLE SIDE) 
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FIG В.2: 60 PIN PBOX CONNECTOR SOCKET 
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SECTION C: ΡΒΟΧ CARD ELECTRONIC FEATURES 


1.0 Introduction 


Each peripheral card designed to be used with the PBox will have 
certain features that will not only allow the device to work properly, 
but will keep it from interfering with other devices and the computer. 
Due to the diverse nature of possible peripheral devices, not all of 
the following electronic features will be implemented on every device. 
The peripheral designer is responsible for insuring that his or her 
design utilizes the appropriate buffering and device selection 
techniques to prevent bus contention between devices. 


2.0 Interfacing Notes 


As noted previously, the PBox has two basic bus systems, memory 
and CRU. The CRU bus is used to control most peripherals, while the 
memory bus is used to transfer data to and from the peripheral. The 
CRU bus can also be used to transfer data to and from ἃ peripheral, 
but a slower rate since the CRU bus transfers information at the rate 
of one bit per cycle, whereas the memory system transfers one byte (8 
bits) each cycle. 

These two buses can be used in several designs to communicate 
between the computer and the peripheral. However, most interface 
designs can be grouped into one of five categories: 


1) CRU only (serial) 

2) Memory only 

3) CRU and Memory Mapped (non-DSR) 
4) CRU, DSR ROM, and Device 

5) Non-CRU Memory Mapped 


Each of these categories are discussed below. Note that the 
fourth category is the most common design, and the last category has 
not been defined until now. 


2.1 CRU Only 


In many ways, interfacing the computer to a peripheral via the 
CRU bus (only) is the simplist design of all. А peripheral that uses 
only the CRU bus to communicate has only one constraint: the CRU 
address(es) used by the peripheral must not be used by any other 
device. This is extremely important because most of the peripheral 
devices and the 9901 which drives the keyboard already have several 
CRU addresses assigned to them. Attempting to use any of these CRU 
addresses will result in contention on the CRU bus, and possible 
activation of other peripherals on the memory bus. [Following 
sections will explain how the CRU bus is used to poll and activate 
peripherals.) Section G contains the CRU map for the /4A. Each 20100 
CRU address block has 128 addresses. Each peripheral space in the 16 
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locations reserved for peripheral devices (from 21000 to »1F00) has 
128 CRU addresses available; however, usually no more than the first 8 
CRU bits are used. The TMS9901 utilizes 32 CRU bits, starting at 
address 20000. Тһе CRU space from 20400 to >OFFE is unassigned апа 
has 12 sets of 128 CRU addresses available. It is recommended that 
peripherals based upon using the CRU bus only should be located within 
the 20400 to ООҒҒЕ CRU address range, with 128 bits available per 
CRU-only peripheral space. Table C.1 defines these twelve peripheral 
blocks. If more than 128 bits are required, then sequential 
peripheral blocks should be utilized. Any device that utilizes one or 
more of the peripheral blocks in Table C.1 shall have the CRU 
addresses clearly identified in the device documentation, and noted on 
the device itself, if possible. None of the CRU-only peripheral 
blocks are currently defined. 


TABLE C.1 
CRU-ONLY PERIPHERIAL BLOCKS 


Block CRU Address Range 
50400->04ҒЕ 
>0500->05FE 
>0600->06FE 
>0700->07FE 
20800->08ҒЕ 
>0900->09FE 
>0А00->0АҒЕ 
20В00->0ВҒЕ 
20С00->0СҒЕ 
10 »0D00-»ODFE 
11 20Е00->ОЕҒЕ 
12 >OFOO->OF FE 


sO омео Qn ошого هھ‎ 


Note: While it is possbile to utilize CRU addresses within the 
sixteen polled peripheral spaces, it is not recommended since these 
bits may be used in existing or future devices. The twelve CRU-only 
peripheral blocks defined in Table C.1 should provide adequate space 
for development of these types of peripherals. 


2.2 Memory Only 


As seen in the /4A memory map, there is a total of 48K possible 
RAM space available, consisting of the following 8K blocks: »2000, 
24000, 26000, »A000, »C000, and >E000. Utilization of these spaces is 
discussed below as they pertain to use in the PBox. 


2.2.1 32K Design 


The TI 32K RAM peripheral card covers the 22000 and }ΑΌΟΟ-ΣΕΕΕΕ 
memory spaces. Since the operating system of the /4A was designed to 
utilize RAM in these memory blocks, there is no need for special 
controls (such as CRU) to activate this memory device, only simple 
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address decoding. (See Section E.2 for more details.) The original TI 
memory card utilizes dynamic RAM; subsequent third party devices use 
more commonly available static RAM. Low power CMOS RAM is used in 
some designs along with batteries to retain data when the PBox power 
is off. 


2.2.2 24000 Space 


The memory space from 24000 to >5FFF is reserved for paging in 
various peripheral devices and for memory mapped devices. See 
Sections 2.3 to 2.5. 


2.2.3 26000 Space 


The space >6000->7FFF is traditionally not accessed from devices 
in the PBox because the /4A system assumes that it will be accessed 
from a cartridge in the 36 pin module port. The signal -ROMG on pin 
34 is used to activate the 8K block at 26000. Bus contention will 
occur if a device іп the PBox contains RAM/ROM at 26000, and a plug-in 
cartridge contains RAM/ROM/GROM at the same location. Peripheral 
devices containing memory in this 8K location are acceptable only if 
the memory is inactive upon powerup, and is activated by the user via 
hardware (switch) or software (CRU activation). This places the 
burden upon the user to activate this RAM space only after confirming 
that no module with memory in the 26000 space is inserted in the 
console. If software checking is used, a powerup routine that looks 
for "AA" at byte 26000 can be used to confirm that the space is not 
free for use. 


2.2.4 Bank Switching 


Bank switching via CRU control is acceptable for the 22000, 26000 
and >A000->FFFF memory spaces. However, most applications programs, 
especially BASIC utilizes these areas in predefined routines, 
particularily the 22000 block. Therefore, bank switched RAM blocks 
are useful for programs specifically designed to utilize them. As 
with other concepts, the designer must insure that two RAM blocks do 
not occupy the same address space simultaneously. Bank switching 
circuitry should be disabled by powerup or RESET activation. 


2.2.5 Extended Address Lines 


The address lines AMA, AMB, and AMC are provided in the PBox bus 
to increase the linear address space of the system from 64K to 512K. 
As with bank switching, use of these lines to extend the available 
memory space is acceptable, but useful only for programs specifically 
designed to utilize them. Α different interface card is required for 
the /4A system to allow use of AMA-AMC, since the card holds these 
signals high. Any memory device that uses these lines must make sure 
that AMA-AMC are high (=1) when accessing the "normal" 32K. Also, the 
designer should note that most of the TI produced peripheral cards 
are not activated if either AMA, AMB, or AMC are low. 
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2.2.6 Memory Mapping 


An advanced technique for extending memory for peripherals is 
referred to as memory mapping. This technique is similar to bank 
switching, but utilizes a specialized LSI chip, the 74LS612 memory 
mapper to control generation of address lines beyond А0-А15. Тһе '612 
can be utilized to expand the address lines to accomodate up to 16 Meg 
bytes, without utilizing AMA-AMC. If a memory peripheral is designed 
to address more than 512K, then it is recommended that a memory mapper 
be located on the peripheral to generate local extended addresses for 
that device. [A description of the '612 and an application report is 
given in TI's "LSI Logic Data Book", 1986] 


2.3 CRU Select and Memory Mapped (non-DSR ROM) 


The /4A system is designed to sequentially poll 16 peripheral 
spaces, all located in the 24000 memory space. Тһе CRU bus is used to 
select and activate these perpherials one at a time to prevent bus 
contention. The system and the 16 peripheral spaces are described in 
Section 4.0. This section covers memory mapped devices that are 
placed in one of the 16 polled peripheral spaces. These devices may 
or may not also have applications ROM/RAM; but it does not contain a 
valid Device Service Routine program. Section 2.5 covers memory 
mapped devices that are not polled by the /4A system, and do not have 
Separate applications programs within their assigned memory space. 

Memory mapped devices are accessed at only one address, or a 
small series of addresses. An existing example of a memory mapped 
device is the 9918A video chip. For the purposes of this section, it 
is assumed that these devices do not require a Device Service Routine 
(DSR) ROM to properly operate. An applications ROM or RAM of up to 8K 
length may be located within the same peripheral space, as long as it 
does not place the value "AA" in the first byte, and its assigned 
address range does not include the memory mapped address(es). This 
type of device may be activated by the /4A peripheral polling system, 
but will not respond since it does not have a valid DSR header. This 
type of peripheral is different from the standard polled peripheral, 
described in Section 4.0, in that it does not need a powerup, 
interrupt or applications program that uses the /4A polling and PAB 
access system, but does need valid addresses for memory mapped 
devices, and possibly an applications program to run. Since it would 
be located in the 24000 block, 1% can not be activated while the 
polled peripherals are being accessed. 

For this type of регірһега1, the following requirements must be 
met: 

a) The memory mapped device must be located in the range of 
>4002->5FFF; it cannot be located at either 24000 or 24001 since it 
might be accidently activated by the polling system. 

b) The memory mapped address(es) must not overlap with any 
ROM/RAM activated by this device. 

с) The memory mapped address decoder chips, data buffers and 
ROM/RAM select chips are to be activated only when that peripheral 
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space is selected by the CRU bus by the calling program, and be 
deactivated when the peripheral is not selcted. 

d) The peripheral must be activated by writing a high CRU bit 
(=1) to the card, and deactivated by writing a low value (=O) to the 
same bit. To avoid spurious activation by the /4A polling system, it 
is recommended that the activation CRU bit not be at CRU bit 0 for 
that peripheral space. 

e) If the memory mapped device requires interrupts to communicate 
with the console, or a powerup/reset program, then it must have a 
valid DSR ROM (Section 2.4). 

f) Applications software must be provided to properly activate 
the peripheral and insure that it is deactivated when communication is 
complete. Due to potential bus contention from another interrupt 
driven peripheral (which would automatically activate the polling 
system), all interrupts should be suspended via a LIMI 0 command by 
the applications software, then restored when the device is 
deactivated. 

g) The device should utilize one of the peripheral spaces and its 
assigned CRU bit address range from the table in Section 4.0. 


An example of this type of peripheral would be a Real Time Clock 
(RTC) that is periodically read by an applications program, and does 
not generate interrupts. The applications program would convert the 
RTC's output into the desired format, and place the time on the 
screen. When the applications program reads the RTC, or writes to set 
the time, external interrupts are suspended, the peripheral device is 
activated and accessed, then deactivated and interrupts аге 
reactivated. 


2.4 CRU Select, Device and DSR ROM 


This type of peripheral is similar to those described in Section 
2.3, except that a ROM device with a valid DSR must be included for 
the device to properly respond to the /4A polling system. The 
Software section of this manual covers requirements for creation of 
DSR software. ROM/RAM up to 8K in length may be located in the 
>4000->5FFF space, and must not overlap with any other device on the 
peripheral that is memory mapped or uses other address decoding 
Schemes. 

For this type of peripheral, the following requirements must be 
met: 

a) Тһе DSR memory must be located starting at address 54000, and 
may extend to >5FFF. 

b) Permanent memory (ROM, PROM, EPROM, EEPROM) is recommended for 
holding the DSR. RAM may be used, if loaded after powerup. Use of 
RAM for holding the DSR prevents use of the peripheral until the DSR 
is loaded. Non-DSR RAM (for scratchpad or data storage) may be used 
as long as the total memory (DSR + non-DSR) is 8K or less. 

c) Any other devices on the peripheral must not share the same 
address space as the ROM/RAM. 

d) The DSR memory must be designed such that the data buffers, 


DSR ROM/RAM select chips and any other device requiring address 
decoding are to be activated only when that peripheral space is 
selected by the /4A polling system. This system requires that the 
first CRU bit of that peripheral space activate the peripheral by 
writing a high value (21) when it is selected, then deactivate the 
peripheral by writing a low value (=0) to the same CRU bit. 

e) 1f the peripheral utilizes interrupts, then it must have an 
open collector driver connected to ground that can be cleared by the 
applications software once the peripheral is accessed. 


An example of this type of peripheral is the RS232 cards, which 
are located at 21300 and 21500, and contain both DSR ROM and other 
chips, like the TMS9902 UART. See Section 4.0 for more details on how 
these peripherals are accessed by the /4A system. 


2.5 Non-CRU Memory Mapped Devices 


One of the drawbacks of the /4A's memory map is its utilization 
of the 8K memory space at 28000 to »9FFF. This memory space is 
assigned to the internal RAM and seven memory mapped devices, all of 
which are block decoded in IK increments. Therefore, the RAM and 
memory mapped devices will respond whenever an access is made to an 
address within the assigned 1K block. 

To allow for implementation of memory mapped devices NOT accessed 
internally by the /4A system, the memory space of 24000->БЕҒЕ is 
assigned for non-CRU memory mapped devices. This space can be 
accessed only when none of the 16 polled peripherals are paged in by 
the CRU bus. 

For this type of peripheral, the following requirements must be 
met: 

a) The peripheral must be disabled whenever a CRU access is made 
to one of the 16 polled peripherals, and enabled only when none of the 
polled peripherals is active. 

b) The peripheral must be decoded to respond within one of the 8 
1K blocks as defined below: 


Memory mapped space Address 
24000->43ҒҒ 


>4400->47FF 
>4800->4BFF 
>4C00->4FFF 
>5000->53FF 
>5400->57FF 
>5800-> 5 BFF 
>5C00->5F FF 
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If more than one address is needed, it shall be within the 
assigned 1K block. 
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FIG. C.1: PERIPHERAL TYPES 
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3.0 General Notes on buffering, Activation, and Misc. Signals 


To insure that peripheral devices do not cause bus contention, 
and are accessed properly, certain design features must be 
incorporated. Most devices wil! have to be buffered from the memory 
bus, activated only when that device is selected, and be capable of 
generating signals to the console of its status. The following 
sections discuss these design features. 


3.1 Buffers 


Devices which utilize the data bus must have a bidirectional 
driver, such as a 'LS245, with direction control and enable signals. 
The bus driver chip should be activated by the peripheral activation 
CRU bit (see 3.2) if a polled peripheral; other peripheral types wil! 
utilize other activation schemes. Other signals (address, control) 
should be driven by a 'LS244 (except as noted in 3.4), which is always 
active. 


3.2 CRU Peripheral Card Activation 


Polled peripherial cards in the PBox are activated by writing ἃ 
high value (=1) to the first CRU bit of the assigned CRU peripheral 
Space. For example, to activate the peripheral card at location 
21500, CRU bit 21500 is turned "оп! (=1) via the 580 command. The 
first CRU bit shall be used to enable the data buffer, DSR ROM (if 
used), and indicator LED. CRU activated cards without DSRs should use 
a CRU bit other than bit O for activation. This bit may be used to 
enable any other chips located on the peripheral card; thereby 
reducing power requirements when the card is not selected. An 
indicator LED shall be provided to give the user visual feedback that 
the peripheral card is active; yellow LEDs are recommended for 
consistancy. Тһе CRU bit is not the only enable signal for the DSR 
ROM; see section 3.3. The CRU bit must be latched by a flip flop, 
'LS259, 9901, or similar device that is capable of storing the status 
of the CRU bit. Provisions must also be made in the design for use of 
the -RESET signal to clear the latch whenever -RESET goes low. 

For non-CRU memory mapped devices, the device must be selected 
only when the assigned address is selected and none of the first bits 
of the 16 peripheral spaces is activated. Circuitry must be provided 
to track the status of the peripheral activation bits, and to deselect 
the memory mapped device if one of these CRU bits is activated. 
Provisions must also be made in the design for use of the -RESET 
signal to clear the non-CRU activation circuitry whenever -RESET goes 
low. 


3.3 Memory Activation 


All memory devices, whether for general storage or memory mapped 
devices, must use address decode circuitry to insure that the device 
will be activated at its assigned address(es). General storage memory 
(at the 22000, 26000, or >А000->Е000 blocks), must be activated by use 
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of upper address lines and -MEMEN. No CRU bits are required to 
activate general storage memory locations. 

Likewise, non-CRU memory mapped devices, CRU memory mapped 
devices and DSR ROM/RAMs are activated by use of appropriate address 
lines, -MEMEN, and the CRU bus. These devices must be located in the 
24000 to БЕРЕ address range. DSR ROMs must start at 24000; other 
devices are not required to start at address »4000. 

As noted previously, the READ access time for memory devices is 
650 ns, which is extremely generous, and should allow use of 'LS type 
decoders for use with the /4A system. 


3.4 Miscellaneous Signals 


Peripheral cards must use certain signals to communicate with the 
console and other peripherals. These signals and design notes are 
discussed below. 


3.4.1 READY: System Ready signal 


Used to put the 9900 in a WAIT state during initialization, or to 
extend a memory access cycle for slow memory devices. If used by the 
peripheral card, it must be an open collector driver (like an !LS125) 
that is tied to ground. Note- activation of the READY signal is the 
sole responsiblity of the individual peripheral and not the console. 
Failure to deactivate the READY signal will result in an inoperative 
System. Note also that this signal is driven out of the card to the 
console. 


3.4.2 -RESET: active low console driven Reset signal 


This signal should be used on peripheral devices to clear the CRU 
activation bit, as well as any other CRU bits, and any other device 
that must be reinitialized to function properly after a low -RESET 
signal. It should be driven into the peripheral by an 'LS244 or 
similar chip. 


3.4.3 PCBEN: active high PCB Enable 


This signal is gated with other signals to activate a peripheral 
card. It can be driven into the peripheral by ап 115244, or taken 
directly into the PCB with no driver chip. 


3.4.4 -RBDENA: active low Remote Data Bus driver 


-RBDENA must be provided to indicate to the Interface Card that a 
memory cycle (Read/Write) is needed for a peripheral in the PBox. It 
enables the 'LS245 on the console end of the cable. It is recommended 
that an open collector signal ('LS125) or tri-state gate ('LS244) tied 
to ground be used to drive the signal, with the gate controller tied 
to the same signal used to activate the data bus driver. 


3.4.5 CRUIN: CRUIN signal 


Usually does not have buffer drivers. Signal sent unbuffered 
directly to CRUIN pin of the 9900. 


3.4.6 -LOAD: console LOAD input 


-Load should not be used by a peripheral for the /4A system and 
standard Interface Card. The Interface Card sold by TI did not 
connect the -LOAD signal in the PBox to the console. Use of the -LOAD 
Signal assumes use of 32K memory exapansion, since the LOAD interrupt 
vectors are at >FFFC апа >FFFE. Therefore, peripherals for the PBox 
cannot use the -LOAD signal with the /4A system and interface as 
released by TI. 

Use of the -LOAD signal is permitted with non /4A systems, or /4A 
systems modified to properly use the signal. If used, an open 
collector ('LS 125) tied to ground should drive the signal. Note- the 
TIl-released disk drive controller drives the -LOAD signal 
periodically. Any new peripherals designed to utilize the -LOAD 
signal must either acknowledge the presence (and possible conflict) of 
the disk drive card, or require the user to disable the -LOAD driver 
on that card. TI has stated that the use of the LOAD signal on the 
pe drive controller card was for use with an unreleased console, the 

4B. 


3.4.7 -INTA: external interrupt to console 


This signal informs the console that the Interrupt Service 
Routine in the peripheral's DSR ROM must be serviced. The signal must 
be driven by an open collector ('LS125) tied to ground. The gate 
controller must be activated and deactivated by the peripheral. The 
signal must be activated only when an interrupt is requested. The 
signal must be deactivated only after the interrupt service routine 
has been accessed by the console. 


3.4.8 -SENILA, -SENILB: Interrupt Sense Enable Levels А + В 


Values for these lines are set by the Interface Card as a high 
level (45V). If the peripheral is to be used with a non /4A system, 
utilizing these signals, then -SENILA and -SENILB must be driven into 
the card by an 'LS244 or similar driver. As noted earlier, -SENILA 
enables 8 of 16 peripherals to drive one of 8 bits on the data bus 
low, while -SENILB causes the other 8 peripherals to place a unique 
interrupt code on the data bus; this allows the system to rapidly 
identify the peripheral. 

If the Interrupt Sense Enable system is implemented at a later 
date, then each of the 16 polled peripherals may be assigned опе bit 
on the data bus for interrupt identification as shown in Table C.2. 
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TABLE C.2 INTERRUPT IDENTIFICATION BITS 


-SENILA Active -SENILB Active 

CRU Data Bit CRU Data Bit 
Address Device Active Address Device Active 
21300 RS232-1 DO 21000 Unassigned DO 
21300 RS232-2 D1 21100 Disk drive D1 
21400 Unassigned D2 21200 Unassigned 02 
21600 п D3 21700 " D3 
21500 В5232-3 D4 21900 > D4 
21500 RS232-4 D5 21800 Қ D5 
>1A00 Unassigned D6 21000 i D6 
21С00 " D7 21Ғ00 " D7 
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The RS232 positions were established by TI; see section F 2.0 
for details. 


To allow for development of future peripherals with this 
Capability from various developers, the following guidelines are 
recommended: 

1) Identify on the peripheral card and in the documentation that 
the device will utilize the "A" and "B" interrupt sense levels. 

2) Provide a switch or jumper on board to allow the user to 
disable the -SENILA/B circuits. 

3) Provide a switch or jumper оп board to allow the user to 
assign the ID bit to the peripheral to match individual system 
hardware/software needs. 


4.0 Peripheral Polling System 


Several peripheral concepts for the /4A system have been 
discussed in this chapter- CRU-only, non-CRU memory mapped, memory 
only, CRU and non-DSR, and CRU and DSR. Of these, only the last (CRU 
and DSR) is automatically polled by the /4A operating system. Polling 
is a technique whereby the console will use the CRU bus to activate 
one of 16 peripheral locations in the >4000->5FFF memory block, апа 
perform a function. Activation of a peripheral also activates its DSR 
ROM, which contains the software program(s) used with that peripheral. 

As noted in Section I, the peripherals may automatically be 
polled by the /4A under the following conditions: 


1) INITIALIZATION (RESET): Some devices require initialization of 
registers or other functions when the system is first activated, or 
following a software reset. 

2) INTERRUPT: Devices that use interrupts must be polled to 
determine if an interrupt has occured; the interrupt must be cleared 
after processing. 

3) DEVICE ROUTINE: This is the application program that is used 
to make the peripheral work. When requesting a certain device ("PIO", 
etc.), the console will search for the DSR that corresponds to that 
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device and execute the program. 

4) BASIC SUBPROGRAMS (CALLS): Likewise, when BASIC or EXTENDED 
BASIC make subroutine CALLs, the /4A will search the available DSR 
ROMs for the corresponding program. 


In each of the four categories, the /4A operating system performs 
the peripheral polling within the 16 locations defined at 20100 
intervals between 21000 to 21Ғ00. Тһе /4A will search for the 
routine, starting at location >1000. If it does not find what it is 
looking for there, it checks the peripheral at 21100, and 50 on, 
incrementing the CRU address by 20100 until the peripheral at 21Ғ00 is 
checked. If no corresponding routine is found, an error message is 
returned. 

Peripheral devices in the other categories are not polled by the 
operating system, and will not be checked automatically (unless 
directed by a DSR in one of the 16 locations that directs the console 
to check а non-DSR device). It is recommended that any peripheral 
device that requires initialization, interrupts, device routines 
(independent of the 32K RAM space) or BASIC CALL subroutines, be 
placed in a polled peripheral space. 
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SECTION D: TYPICAL CARD CHIPS 


1.0 Introduction 


This section is provided to assist the designer with a quick 
reference to integrated circuit chips commonly used in peripheral 
devices for the /4A system. The chips listed are not 'all' of the 
chips that could be utilized; the designer should have access to data 
books such as "Standard TTL, Volumes 1 + 2", "LSI Logic Book", "ALS/AS 
Logic Book", апа "Interface Circuits Data Book" from Texas 
Instruments. A complete list of logic data books is available from 
Texas Instruments. 

The chips are grouped into four types: drivers, logic, decode and 
CRU. Only basic information is given about the chips. Consult the 
data books for more detailed information, such as power requirements 
and propogation delays. 
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FIG, D.2: LOGIC CHIPS 
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SECTION E: TYPICAL CIRCUIT EXAMPLES 


1.0 Introduction 


Peripheral devices for the /4A system can vary greatly in 
complexity and function. However, most of them will have to be 
interfaced to the memory bus, CRU bus, or both. The following 
sections present some typical circuit examples to demonstrate how 
interfacing may be accomplished on the /4A system. As with Section D, 
Typical Chips, these circuits are not necessarily optimal for all 
peripheral devices, but are presented here as а reference for the 
designer. 


2.0 Memory Interface 


This example shows how a device incorporating the 32K RAM could 
be assembled. The integrated circuits used are summerized below, 
along with their function. This example has address decoding, data 
bus buffering, and generating of the -RDBENA signal; these circuits 
are common with most peripheral devices and are not repeated for the 
other examples. 


Chi Function 

244 address and control signal drivers for A0-15, -WE, DBIN 

245 data bus transceiver for 00-7 

138 decode А0-А2 into 8K chip select banks; selects >2000, 
»ΑΟΟΟ, »0000 and >E000 8K blocks 

21 4 input AND gate, activates the -RDBENA and 245 chip 
enable, inputs are from "138 chip select signals 

04 1 of 6 hex inverter, used to convert DBIN to -DBIN (-0Е 
for 8K RAM and 245) 


3.0 CRU Interface 


CRU interface can be implemented rather easily with relatively 
common chips. Figure 3a shows how an 'LS259 is used to latch up to 8 
individual CRU bits. Тһе 'LS138 is used as an address decoder, while 
-CRUCLK is used as an enable signal (to prevent activation during a 
normal memory bus access). The 8 individual bits are selected by 
address lines A12-A14, and the CRUOUT line inputs the value of the bit 
(0 or 1). The -RESET line clears all the bits when the system is 
reset. Тһе 'LS259 is used in the Latch mode which means that the 
value of the CRUOUT line at the time of access is held constant until 
it is either rewritten or reset. Software must be written to insure 
that CRU bits are not accidently left on when a peripheral device is 
no longer accessed. 

Figure 3b demonstrates how to input data via the CRU bus. Once 
again, the 'LS138 is used for address decoding. The 'LS251 is used as 
a 1 of 8 data input, with address lines A12-A14 selecting the input 
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line. Once the line is selected, the CRUIN line reads the value (0 or 
1). The -CRUCLK signal is not used, since it is for data output by 
the CRU bus only. Data at the 8 inputs to the 'LS251 must be valid 
before being read by the CRUIN line. 

The most versatile, and often underused, chip for CRU interfacing 
is the TMS9901. The 9901 can provide 6 dedicated interrupts, 7 
dedicated 1/0 CRU bits, and 9 lines that can individually be 
programmed as either interrupts or 1/0 bits. In addition, it has a 16 
to 4 interrupt prioritizer (which is not used in peripheral designs 
for the /4А, due to the limited interrupt structure), and а built-in 
programmable timer that сап be preset to interrupt at a specified 
interval. Figure 3c shows the basic interconnect for a 9901 to the 
PBox bus. Address decode circuitry selects the chip, while the full 
CRU bus is directly connected to the 9901. The lower address bits 
A10-A14 are used to select the 1/0 and interrupt pins. When ап 
interrupt occurs, the -INTREQ line drives the -XINT line low, and it 
is up to the software to read the interrupts internally to determine 
which one was active. -CRUCLK must be inverted back to positive 
CRUCLK for the CRUOUT line to function properly. 


4.0 Memory mapped interface 


Memory mapped decoding is similar to regular memory interfacing, 
in that various address lines are used to select a particular device. 
In Figure 4a, two 'LS138s are used to decode the 6 most significant 
address lines. With this scheme, the second '138 provides 8 select 
lines that will activate individual 1К blocks. These 8 1K blocks 
reside within the 8K block chosen by the first '138 decoder. When 
used in a polled peripheral, this 8K block would be »4000-»5FFF. CRU 
decoding is used to select the peripheral space and activate the 
device (or DSR ROM) only if both the address is valid, and the first 
CRU bit in the CRU peripheral space is set. 

Figure 4b also uses two chips, but can decode all 16 bits to an 
individual address. The first '688 compares the first 8 MSB (A0-A7) 
to a value set by an 8 switch DIP set. When these 8 bits are equal, 
they enable the second '688, which does a similar comparison for the 
lower 8 address bits. The second !688 produces a low true signal when 
the 16 address bits equal the value set on the DIP switches. Once 
again, this is gated with the appropriate CRU bit to activate the 
peripheral. 

The non-CRU memory mapped decode circuitry is more complex, as 
shown in Figure 4b. Once again, ап 'LS138 is used to decode А0-А2 to 
enable the 24000 8K block. The 'LS154 further decodes A3-A7 into all 
16 possible polled peripheral locations (>1000->1F000). А11 16 
outputs are routed to two 'LS21s (4 input AND gate) which are 
connected such that the final AND gate output goes low if any of the 
16 inputs goes low. This, along with other signals is latched by a 
259. This circuit will provide а master output signal, -Qo, that 
follows the following logic: 
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IF -Qo is low THEN a polled perpiherial is active and the non-CRU 
memory mapped device CANNOT BE ACTIVE. 


IF -Qo is high THEN no polled peripheral is active and the 
non-CRU memory mapped device CAN BE ACTIVE. 


This circuit must be combined with other address decode circuitry 
to select the peripheral within the 26000 block. 


SECTION E: TYPICAL CIRCUIT EXAMPLES 0 εὐ 


FIG. Е.Р: MEMORY INTERFACE EXAMPLE 
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FIG. E.4: ΜΕΜΠΕΥ MAPPED EXAMPLE 
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SECTION F: TI DEVELOPED CARDS 


1.0 Introduction 


Texas Instruments developed and sold 4 cards for the peripheral 
expansion box: the RS232, 32K memory, disk drive controller and P-code 
card. Reference 4, the Bunyard Manual, has a very detailed 
explanation of how each of these cards are put together. For purposes 
of comparison of design methodology (this document vs. TI), a brief 
description of the interface circuitry for the RS232, 32K memory and 
disk drive controller is provided. 


2.0 RS232 card 


!LS244s are used to drive А0-А15, AMA-AMC, -CLKOUT, -MEMEN, -МЕ, 
-CRUCLK апа DBIN. Ап 'LS245 is used for DO-D7, with DBIN determining 
the data flow direction. An 'LS125 is used to drive pin 17, -XINT, 
and -RDBENA. CRUIN is brought on the board unbuffered, as well as 
PCBEN. The majority of the address decode is done by a Programmable 
Array Logic (PAL) chip. On the RS232, as well as the other cards, 
that AMA-AMC and PCBEN must be active high to select the card. The 
RS232 card can also drive DO and D1, or D4 апа 05 if an interrupt 
occurs, and -SENILA is brought low. The Bunyard Manual notes that the 
CRU address of the card can be changed by moving one resistor. 


3.0 32K memory card 


'LS244s are used to drive А0-А15, AMA-AMC, -MEMEN, and DBIN. 
Neither CRUCLK or -WE аге used by this card. -RDBENA is driven by ап 
15125 when the card is selected, and ап 'LS245 controls the data on 
00-07, with DBIN controlling the direction. Тһе interesting item оп 
this card is the lack of use of the -WE signal. А PAL controls the 
32K worth of dynamic RAM, which is much more complicated than need be 
if static RAM were used. Also, PCBEN is not used in the decode logic. 


4.0 Disk drive controller card 


Once again, 'LS244s drive А0-А15, -MEMEN, -WE, -CRUCLK, DBIN, 
AMA-AMC, and -CLKOUT. PCBEN and CRUIN are unbuffered, as well as 
-RESET. Ап 115245 carries the data on DO-D7.  -RDBENA and READY are 
driven by an 'LS125. А PAL is used for most of the address decode 
logic. The disk drive controller does not drive -XINT, but does have 
an active, but unused interrupt signal -INTRQ. This originates from 
the WD1771 controller chip, and is connected to pin 18, -LOAD on the 
PBox bus. An 'LS125 also drives DO low if -SENILB is low. 
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SECTION G: PERIPHERIAL LOCATION ASSIGNMENTS 
1.0 Introduction 


As noted previously, there are 16 CRU defined locations available 
for peripherals for the /4A system. Of these 16, four locations are 
assigned to existing products released by TI. Other locations were 
reserved by TI, but the planned peripherals were not released. Table 
G.1 lists the 16 peripheral spaces by their CRU address, indentifies 
the address values to decode that space, and defines the assignment of 
all spaces. The functions were arbitrarily assigned, but were done so 
to help developers determine where their product should be located in 
the peripheral space, thereby minimizing conflicts between different 
devices. It is recommended that peripheral developers include 
circuitry on their devices (similar to the examples in Section E) to 
allow the user to select the CRU location for the device in their 
individual systems. While this design feature could result in 
conflicts between two devices accidently assigned to the same 
peripheral space, it does allow maximum flexibility for the end user. 
Any documentation accompanying the device should clearly identify the 
recommended CRU location. 

The space assignments are choose to correspond with individual 
peripheral products currently available with various computer systems. 
Availability of any peripheral product listed in Table G.1 is 
dependent upon the efforts of the hardware developer, and does not 
necessarily imply that such a product exists, or will at a later date. 
Two peripheral spaces are left undefined to allow for prototype 
projects, or future devices whose function is not clearly defined 
elsewhere in Table G.1 
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Addr. 


Peripheral Space Lines 


=======-====================s==s<s===========-=====-<-=================-=<==-===== 


21000-210ҒЕ 
21100-211ҒЕ 
21200-212ҒЕ 
21300-213ҒЕ 
>1400->14FE 
>1500->15FE 
21600-216ҒЕ 
21700-217ҒЕ 
>1800->18FE 
>1900->19FE 
>1A0G->1AFE 
>1B00->1BFE 
»1C00-»1CFE 
>1D00->1DFE 
>1E00->1EEF 
>1FOO->1FFE 


*I tems 


devices. 


in 


10000 
10001 
10010 
10011 
10100 
10101 
10110 
10111 
11000 
11001 
11010 
11011 


parenthesis 


Table G.1 


Established 
Function* 


disk controller 
(home security) 
RS232-1 

(internal modem) 
RS232-2 

(digital cassette) 
Hex Bus 

thermal printer 
(eprom programmer ) 
(student typing) 
(debugger card) 
video 

IEEE 488 control 


Peripheral Location Assignments 


Assigned 
Function 


mass storage 
disk controller 
math coprocessor 
RS232-1 

internal modem 
RS232-2 
prototype low 
attached computer 
MIDI /music 
programmer 
speech/DSP 
Utility card 
video 

real time clock 
prototype high 
P-code 


\ 


denote third party or unreleased ТІ 
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Table G.1 Notes 


1) Mass storage is currently defined as RAM disks, but also 
includes other media such as CD-ROM. 

2) Position 21200 is reserved for high speed math coprocessors, 
which may be interrupt driven and require quick response times. 

3) An internal modem is defined as a standalone peripheral with 
direct connection to telephone lines, with no interface to the RS232 
devices. 

4) Prototype locations (low and high) are left undefined for 
prototype circuits and undefined future products. 

5) These card positions were defined by TI; however, the 
peripheral either was not released, or is seldom used. Therefore, 
this peripheral space was reassigned. 

6) Attached computer or microprocessor refers to a self contained 
computer system with its own microprocessor. This space can also be 
utlitized for interfacing to independent computers. 

7) This space is reserved for electronics music devices. 

8) This space is reserved for programmers of various devices, 
Such as PROM, E(E)PROM, PAL, etc. 

9) This space is reserved for speech and/or digital signal 
processing devices. 

10) A utility card refers to peripherals designed to enhance or 
supplement development of assemlby or other advanced program 
applications. 

11) Real time clock peripheral space; also used as RTC space by 
some third party products. 
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SECTION H: MISCELLANEOUS DESIGN CONSIDERATIONS 


1.0 PBox Peripheral Card Dimensions and Layout 


Figure H.1 gives the physical dimensions of a printed circuit 
board designed to fit іп the /4А PBox. These dimensions are taken 
from the prototype board, and assume that the card will be bare (ie- 
will not use a 'clamshell' cover like the original TI cards). These 
dimensions are extremely useful for designers who are planning to 
produce PCBs for kits or final projects, or for the hobbiest who 
constructs his or her own one-of-a-kind PCBs. The extension section 
in the rear is optional, and is designed to extend outside of the 
PBox; it is not needed unless external connections are used by the 
card. Positioning of the indicator LED is relatively critical - it 
must line up with the built-in lens of the PBox to give the user a 
good strong light signal. 

Drivers and buffers must be physically located as close to the 60 
ріп edgeboard as possible. Unregulated 48V, +16V, and -16V are 
provided at opposite ends of the card for input to voltage regulators. 
If the +16V and -16V pins are not used, it is recommended that their 
edge connectors not be put on the PCB. This will eliminate accidental 
shortage of the unregulated voltage with adjacent signals, such as 
-MEMEN. Voltage regulators may be mounted directly to the PCB for 
heat sinking purposes. Voltage regulators should have heatsinks with 
heat sinking compound in most designs, particularily if the circuit 
draws more than one-half of the rated output of the regulator. 
Regulators should also have enough de-spiking capacitors to ensure 
reliable performance. 

Layout of other components on the PCB should not be critical. 
PCB traces with signals or power feeds should not be routed near the 
front or back, where they could accidently short to ground against the 
PBox chassis. ΑΙ] PCB areas not utilized for traces should be left 
unetched (ie- solid copper), and tied to ground to act as а ground 
plane, and minimize external signal interference. Any connecting 
hardware such as plugs, sockets, etc., that will have cables inserted 
ànd removed should be bolted to the board to prevent damage to the PCB 
from repeated insertion/removal. 

Each peripheral card should not use more than the following 
maximum power on the three unregulated power buses: 

500 ma on 8V 

250 ma on 16V 

30 ma on -16V 

This is a function of the PBox power supply, split over a maximum 
of seven cards. If more power is required by an individual card, an 
independent power supply with common ground should be used. 


2.0 Prototype Board 


Designers wishing to test their peripheral circuits prior to 
manufacturing PCBs can utilize a prototype PBox board, which is 


1 
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currently available from LL Conner Enterprises. This is a wire wrap 
type board with all signals brought on board from the bus, and 
positions for bus drivers and buffers provided. Multiple positions 
for memory and general purpose chips are also provided, as well as for 
the voltage regulators. 

If the prototype board is unvailable, then prototypes can be 
constructed from breadboard/wirewrap board with a 60 pin plug that is 
compatible with the PBox bus (TI part # L21111121-30). 


3.0 Extender cable 


Access to circuit boards installed іп the PBox is extremely 
limited. То facilitate easier testing and troubleshooting of 
prototype devices, the hardware designer may wish to construct a bus 
extender cable. A bus extender cable may be constructed by connecting 
a 60 pin edgeboard plug to a 60 pin edgeboard connector (0.1" pin to 
pin spacing for both) with two 30 conductor ribbon cables. А maximum 
of two feet of cable is usually desirable to allow for ease in placing 
the prototype card in a convenient location. Use of shielded cable is 
recommended to minimize EMI/RFI interference. 


4.0 Modified Interface Card 


As noted in several previous sections, the Interface Card sold 
with the PBox limits the use of some signals in the PBox bus. X Figure 
H.2a is a simplified diagram of a modified interface card that 
duplicates the function of the original interface card, but also 
allows use of some of the restricted signals. 

AMA-AMC, -SENILA/B, and HOLD are connected to 45V via resistors, 
but also have a DIP switch set that allows these lines to float 
(neither +5V or ground), like SCLK, IAQHA, etc. РСВЕМ must be held to 
5V to allow the TI developed cards to operate, and does not have a 
switch. -LCP is tied to the chip enables for the address and data 
drivers such that a low value will disable the interface card. The 
design shown in Figure H.2a would be useful in implementing a system 
that has an independent computer/microprocessor in a peripheral space 
that occasionally takes over the PBox bus from the /4A. Software 
between the two systems would be responsible for disabling and 
enabling the interface card. [This system would not be required if 
HOLD and -HOLDA were available at the /4A 44 pin side port.] 

A slightly different design for the interface card 15 shown іп 
Figure H.2b. Here, signals such as AMA-AMC, -SENILA/B, etc., are 
taken to the console end of the interface cable, where an undefined 
'black box' is used to generate signals under software control. AS ап 
alternative, the black box circuitry could be on tne interface card in 
the PBox. This design assumes the /4A will generate all new signals. 
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FIG. H.A: MODIFIED INTERFACE - INDEPENDENT MICRO IN PBOX 
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SECTION I: DSR ARCHITECTURE 


1.0 Introduction 


This section briefly covers the software required to make 
peripherals compatible with the /4A and its File Management System 
(FMS). Software for a standard peripheral is referred to as a Device 
Service Routine, or DSR. Section I discusses the basic parts of a DSR 
and gives coding examples. Section J examines how the console 
accesses DSRs. Section K contains miscellaneous information on direct 
access of peripherals and the non-DSR peripherals from a application 
program, and information on Peripheral Access Blocks (PABs) and how 
they interact with DSRs. 


2.0 Device Service Routines 


Device Service Routines are included on many peripherals to allow 
the /4A to communicate with the device(s) located on the peripheral. 
To simplify the addition of new peripherals, the /4A has a defined 
protocol for interaction with peripherals during inital powerup, 
interrupts, and main device programs. Peripherals may also add new 
subprograms (CALL XXX) to BASIC and XBASIC. The /4A communicates with 
each peripheral in exactly the same manner; it is up to that 
peripheral's DSR to define how the peripheral operates. This way, new 
peripherals may be added without altering the console routines. More 
information on the /4A and its File Management System can be found in 
the Editor/Assembler manual, or /4A Peripheral Technical Data manual. 

DSRs can be located in either GROM or ROM (PROM, EPROM, EEPROM, 
battery backed SRAM) devices. Since GROMs are beyond the scope of 
this manual, further discussion of DSRS will be limited to  ROM-type 
applications only. DSRs can be composed of several different kinds of 
routines, depending on what functions the peripheral is to perform. 
Six types of DSRs are defined: power up, user application, main device 
service, subroutine links, BASIC subprogram libraries, and interrupt 
service programs. Тһе /4A finds and executes these programs by 
searching the ROM header, which is in the first 10 bytes of the ROM. 
The console identifies valid DSR ROMs by checking that byte 0 is "AA". 
[Note: non-DSR peripherals may have applications programs in ROM at 
the same location, but must be called by an independent program in the 
console, and must not have the validation byte (0) set to "AA".] Byte 
1 contains the version number of the DSR. The remaining bytes in the 
header identify the entry points for the various programs used by the 
DSR. Table I.1 identifies the contents of the DSR header. 


Table I.1: DSR Header 


Location Size Contents 

24000 byte YAA valid ID 

4001 byte version number 

4002 byte number of application programs, set to zero 
4003 byte reserved, set to zero 


| SECTION |: DSR ARCHITECTURE NE. E 
4004 word address of first power up header 
4006 word address of first user program header* 
4008 word address of first main device header 
400A word address of first subroutine link header 
400C word address of first interrupt link 
400E word address of first BASIC subprogram library* 


[*Only in GROM or at 26000 location] 


The address of апу routine types should be 20000 in the ROM 
header if there are no routines of that type in tha DSR. The number 
of application programs and version number values (bytes 1 and 2) are 
ignored by the /4A system. Program entry addresses may be placed 
anywhere within the 24010 - »5FFF range, and multiple routines per 
program type are allowed (ie- there may be more than one main device 
routine, interrupt, etc.). Тһе address of the program type given іп 
the header is the link to the next routine of that type. At the first 
address is the linking address of the next routine; the word 
immediately after this address is the entry point of the first 
routine. If the linking address is zero, then no more routines of 
that program type are available. See Examples I.1 - I.5. 

Not all peripherals require all types of routines; it is up to 
the designer/programmer to determine which routines the peripheral's 
DSR will require. As noted in Table I.1, there are four types of 
programs available for DSRs in ROMs: power up, interrupt, main device 
routine and subroutine link [also referred to as BASIC CALL (sub), or 
low level routines]. These program types are discussed next. 


2.1 Power up routines 


Some peripherals require intialization upon power up or following 
a system reset. Or a power up routine may be included simply to flash 
the peripheral indicator light to let the user know that the device is 
active. In either case, they will require a power up routine in the 
DSR. The /4A initializes the console upon power up, then searches and 
executes all peripheral DSR power up routines. 

Each power up routine can use RO-R10 of the GPLWS. R12 will be 
set up with the proper CRU address for the peripheral (which is also 
the CRU address used to enable the peripheral). R11 contains the 
return address. R13 and R15 contain the memory mapped addresses of 
GROM Read Data and VDP Write Address, respectively. ΑΙ] VDP and GROM 
operations сап be indexed from these two registers. R14 contains the 
status flags and should not be altered. The power up routine may use 
VDP RAM from »0000 to the address pointed to by 28370 [note that the 
VDP and its memory are not completely initiated at this point]. It 
may also use all console scratch pad RAM except >8355->836D апа 
»83C0-»83DF. Errors are not assumed to occur during execution of 
power up routines, and there are not provisions in the FMS for 
identifying power up errors. The power up routine may print an error 
message on the title screen to let the user know of a problem with the 
peripheral. If there are no errors, the power up routine returns with 
a B *R11. 
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РІЛ 


PU2 


PUTEN 


РУ2ЕМ 
ЕХІТ 


EXAMPLE 1.1: POWER UP ROUTINES 


AORG 24000 
BYTE >AA 
BYTE 1 
DATA 0 
DATA PU1 


DATA PU2 
DATA PUTEN 
BYTE 0 
EVEN 

DATA 20000 
DATA PU2EN 
BYTE 0 
EVEN 


$ 
$ 
В *R11 


start of DSR 
validation byte 
version number 
reserved 

first power up link 


link to second power up 

entry point of 1st power up routine 
name length, set to zero 

reset pointer to word boundary 

no more power up routines 

entry point of second power up 


entry of 1st power up routine 
entry of 2nd power up routine 


return to console 


[SECTION |: DSR ARCHITECTURE. 


2.2 Interrupt routines 


Interrupt routines are required for peripheral devices that 
generate interrupts, and are connected to the -INTA line. Since іле 
/4А system scans all peripheral interrupt routines to determine which 
DSR caused the interrupt, the DSR must be capable of checking the 
peripheral to determine if it generated the interrupt. The interrupt 
routine must clear the interrupt when the routine is complete. 
Generally, peripheral devices will generate their own -INT signal, 
which is cleared by DSR software. Other designs may incorporate a TTL 
latch. or flip flop that is cleared by CRU or other signal. In any 
case, the -INT line must be cleared prior to exiting, or the console 
will continue to branch to that interrupt routine indefinitely. The 
flow diagram for the interrupt program logic is shown in Figure I.1. 

The interrupt routine can use R1-R10 of GPLWS, except for R9. 
The contents of R13 - R15 are the same as for the power up routines; 
R11 contains the return address. Because of the execution of an 
interrupt routine only as part of a DSR, the DSR and interrupt routine 
can split the allocation of scratch pad RAM from >834A to 28360. An 
interrupt routine is always exited by a B *Ri1. As with power up 
routines, no provisions are made for reporting errors that occur 
during an interrupt routine. 

The RS232 card as released by TI assumes that no other peripheral 
will cause an interrupt while it is in use. Interrupt driven 
peripherals must have routines that either acknowledge this feature, 
or can function around the RS232 card. Refer to the RS232 interrupt 
routine as disassembled and commented in "Technical Drive". 
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Flos 115: INTERRUPT ROUTINE 


Is the -INT low for 
this peripheral? 


return 


execute interrupt routine 


clear interrupt signal 


PG 15] 


SECTION 


INT1 


INT2 


INTEN1 


INTEN2 


CLEAR 


END 
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EXAMPLE I.2: INTERRUPT ROUTINE 


AORG >4000 

BYTE >AA 

BYTE 1 

DATA >0000 

DATA ----- power up routine 

DATA >0000 

DATA ----- main device routine 

DATA ----- subroutine link 

DATA INT1 15% interrupt link 

DATA >0000 

DATA INT2 link to 2nd interrupt routine 
DATA ІКТЕМ1 entry point of 1st routine 
BYTE 0 name length set to zero 
EVEN reset WP 

DATA 20000 no more int. routines 

DATA INTEN2 entry point of 2nd routine 
BYTE 0 

EVEN 

$ entry of 1st device 


[check for interrupt; if none goto END] 
[interrupt service routine] 
[goto CLEAR] 


$ entry of 2nd device 
[check for interrupt; if none goto END] 
[interrupt service routine] 

[goto CLEAR] 


$ clear interrupt 
[reset -INT signal] 


B *R11 


PG 16 
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2.3 Main Device Routine 


The Main Device Routine(s) defines the function(s) of the 
peripheral, and must be included on all peripherals with devices to be 
accessed. As with the power up and interrupt routines, there may be 
multiple main device routines for one peripheral, such as for the 
RS232 card. Main device routines are called via the File Management 
System in the BASIC/XBASIC environment, which establishes PABs in VDP 
memory for each opened file. The device name is located in VDP RAM, 
and is pointed to by a word value at 28356. The device name and 
character count byte is also included in the PAB. The main device 
routine is called by either the File Management System, or by  DSRLNK 
in an applications program. 

R12 will contain the CRU address of the peripheral being 
addressed, and R11 contains the return address. Registers RO-R10 сап 
be used by the routine as well as 2834A ->836D. If an error occurs, 
the DSR must set the error codes in the PAB, as defined in Section K, 
and perform a B *R11. If no errors occur, the routine must increment 
R11 by two prior to exit. However, if the peripheral is not 
interested in responding to the call (ie- the same device name may be 
on more than one peripheral), it may return via B *R11. 

The main device routines often require extensive coding due to 
numerous housekeeping responsibilities that they must perform. These 
responsibilities include: 


1) Maintain interface with FMS 

Device routines are accessed in terms of files and records. [See 
Section 18 of the Editor/Assembler manual]. The designer/programmer 
must determine what data format(s) is appropriate for interfacing with 
the FMS. Changes to the 1/0 status of a peripheral must also be 
handled by the device routine. 

2) Respond to STATUS 1/0 opcode 

As noted in Section K, the DSR should be capable of responding to 
a STATUS 1/0 request by updating byte 8 of the PAB. This byte is used 
to determine the current status of the peripheral. 


3) Report any errors 
The DSR also reports errors that occur during processing of main 


device routines before returning. Section K defines the error codes 
and their meaning. Errors are reported in the FLAG byte of the PAB. 
4) Maintain device housekeepin І 
The DSR must also tend to any requirements of devices located on 
the peripheral while active. The DSR must also properly disable the 
device prior to terminating access. 


The basic flowchart for a main device routine is given in Figure 
1.2. It is based upon a review of the CLOCK, RS232, and Disk Drive 
Controller DSRs. The programmer is responsible for determining what 
1/0 opcodes аге used with the peripheral, and developing the 
appropriate code. Example 1.34 is a typical main device routine 
example. Example 1.30 is the disassembled and commented DSR for the 
CORCOMP 9900 Clock card (from "Technical Drive", by Monty Schmidt, 
reprinted with permission). The programmer may consider using a 
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similar structure in developing main device routines for new 
peripherals. The programmer is strongly encouraged to review the 
disassembled and commented RS232 and Disk Drive Controller DSRs given 
in the manual "Technical Drive". 
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FIG. 


HEADER 
validation byte/ ver sion 
# proms/reserved 
powerup 

user program 

main device 

subroutine link 


1.2: MAIN DEVICE ROUTINE 


main device | 
main device e 
etc. 


ў 


devices wit 
storage onl 


interrupt 
BASIC subprgm Libr ary 


N 


MAIN DEVICE 
store GPLWP 
save return address 
copy PAB into DSR RAM 
set FLAG bits 0-4 


ο ee 


ιών τος. 
t check op-code: does N 
Jump to op-code routine this device use this 4 


op-code? 


»0 OPEN (recover options) 
^e READ 

23 WRITE 

24 RESTDRE/RE WIND 

>5 LOAD 

»6 SAVE 

»7 DELETE 

28 SCRATCH RECURD 

»9 STATUS 


»| CLOSE 

write FLAG byte to VIP 
RAM from DSR 

write character count 
byte to VDP PAB from 
DSR RAM (if a READ op.) 
Ril = ЕП + 2 


[return via R11 


ERROR 
set error bit in 


FLAG byte 
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EXAMPLE 1.38: MAIN DEVICE ROUTINES 
AORG 24000 
BYTE AA 
BYTE 1 
DATA 20000 
DATA ---- 
DATA »0000 
DATA DSR1 link to 15% device routine 
DATA ---- 
DATA ---- 
DATA 20000 
DSR1 DATA DSR2 link to next DSR 
DATA DSREN1 entry point of 1st device 
BYTE 4 name length of 1st device 
TEXT 'DEV1' name of 1st device 
EVEN 
DSR2 DATA »0000 no more DSRs 
DATA DSREN2 entry to 2nd device 
BYTE 4 name length of 2nd device 
TEXT 'DEV2' name of 2nd device 
EVEN 
DSREN1 $ entry point of device 1 
DSREN2 $ entry point of device 2 
ERROR $ entry point of error reporting routine 


OKEND 


[set error bits] 


B *R11 do not increment R11 
$ no errors return 
INCT R11 increment R11 by two 
B *R11 return 
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адаё 
4202 
46604 
4086 
4928 
а4ддА 
3eg8c 
488E 
40109 
42912 
4014 
4216 
4818 
4д1А 
4σις 
4й1Е 
4920 
4022 
4024 
4626 
4028 
492A 
402C 
402Е 
4030 
4052 
48434 
3336 
4838 
403A 
4σσς 
аа@зЗЕ 
4040 


4842 


4044 


4046 


4048 


4@4A 


4σας 


404Е 


4050 
4852 


ААд1 

BOIS 
4838 
SSIS 
403E 
σσσο 
BOBS 
σσσο 
2450 
459C 
2845 
2920 
454Ε 
5059 
5249 
4748 
54260 
5139 
5835 
2642 
5920 
434F 
5243 
ағар 
502С 
2049 
4E43 
2ESS 
ooa 
4062 
2009 
σσσο 
48A4 


0545 


асағ 


азав 


2113 


2884 


ποσο 


1040 


όσεσ 
2C2F 


DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
TEXT 


TEXT 


EVEN 
DATA 
DATA 
DATA 
DATA 
DATA 
BYTE 
TEXT 


BYTE 
BYTE 
BYTE 
BYTE 
BYTE 
BYTE 
BYTE 
BYTE 
BYTE 
BYTE 
TEXT 


Source code for CORCOMP 9900 Clock card 
Dissassembled and commented 3/20/86 


by Monty Schmidt 


yAA01 
79600 
24838 
λσσσο 
> 483E 
76660 
λσσσσ 
Σλσσσο 
20460 
»434C 


'(C) COPYRIGHT 1985' 


' BY CORCOMP, 


>9208 
24062 
79060 
76000 
»48A4 
›25 
‘CLOCK? 


>01 
213 
2696 
264 
750 
›сё 
>19 
›4@ 
>68 
^E, 


Moh,” 


G 


INC.’ 


жж 
жж 
** 
жж 
++ 
жж 
жж 
жж 
жж 
x+ 


ЄН 


жж жж ж ж ож 


"- 9 ш = оце 


Valid DSR identifier and version 
Not used іп DSR calls 

Address Of Power up link 

Not used in DSR calls 

DSRLNK address 

Not used in DSR calls 

INTLNK zero, no interrupt rtn. 
Not used іп DSR calls 

2??? Test routine perhaps 

Points to infinite loop Test rtn? 


Ἐν η M | 


Linkage set to 0: only 1 power up 
Entry point of power up routine 
Name length set to 2 

Linkage to next device field-none 
Entry point of device 

Name length of device 

Device name 


еш 


Number ОҒ characters to read 
Mask byte for write 

Maximum allowable opcode 
ASCII offset for numbers 
Enable byte 

Mask byte for write 


Mask for status and enable byte 


vou 
"oc 
Vou 
vou 
Jc 
J ل‎ 
J cJ 
Y" ν 
vou 
JJ 
ν ν 
Y cw 


43954 SABS EVEN 
4056 @@@A DATA 
4058 0004 DATA 
4ӨЗА 48۴2 DATA 
405С 4080 DATA 
4Ø5E 423A DATA 
4666 4134 DATA 


жж Power up rou 


4062 C18C MOV 
40864 6458 RT 


++ Error Codes 


4066 292901 LI 

48068 4020 

486A 1008 IMP 

486C 202901 LI 
496E 6909 

4625 1005 IMP 
40922 0201 LI 
4074 8000 

4076 1002 1МР 
4228 8201 11 

40274 СОО 

4Ө?С F981  SOCB 

462Ε ΕΕόΒ 


ЖҰ Close Opcode 


4686 σόασ BL 
4982 4112 

4884 4981 DATA 
4086 DBE4 move 
4088 FF6B 

488A FFFE 

408С σόρσ BL 
408E 4112 

4090 4005 DATA 
4092 DBE4 МОУВ 
4094 ΕΕ6Ε 

4096 ΕΕΕΕ 

4098 0ЗЕ4  INCT 
409А ΕΕΘό 

46096 σας8 CLR 
499Е C2E4 MOV 
46406 ΕΕΘό 

46Α2 045В RT 


** DSR Routine 


4044 02A4 STUP 
42046 CIB μον 
46Α8 ΕΕΘό 

46ΑΑ C184 πον 
480AC 0226 ΑΙ 
AGAE ΕΕΖΘ 


DSR ARCHITECTURE 


1g 
4 

›48Е2 
yage2 
423A 
24134 


tine ++ 


R12,Ró 


жж 
R1,»54009 


%%212 
К1.>60002 


»497C 


$t*»90C »407ς 


Ri, 28060 


%%>26 2497C 


Β1,25σ66 


R1,@>FF6B(R4) 


Routine жж 
8»4112 


»4001 


@>FFéB(R4).G@G5FFFE(P15) 


824112 


›аёд5 


@>FFSF (R4) ,@>FFFE(R15) 


Q»FF86(R4) 


кв 
@>FFB6(R4), R11 


жж 


R4 
R11,G»5FF86 (R4) 


R4A,RS 
Ré, >FF78 


жж 
жж 
++ 
жж 
жж 
ж 


жж 
жж 


жж 


жж 


жж 


X4 Attempt to read past end of file 


жж 


жж 


xx 


жж 


жж 


жж 


жж 


жж 
жж 


жж 
жж 
жж 


Constants for write routine 


Open routine address 
Close routine address 
Read routine address 
Write routine address 


Сору CRU address into Ré 
Return 


Bad Open Attribute 


Illeqal Operation 


Out of Table or Buffer space 


Set Status Bit in DSR area 


Set up address to PAB Status Byt 


Write DSR Status Byte to VDP РА 


Set up address to PAB Char count 


Move DSR char cnt to PAB char c 


INCT the return address 


Move return address into R11 


and ao back! 


Store GLPWSP pointer in R4 
Save return address in DSR area 


Move GPLWSP pointer into Ré 
Make it point to 78558 of DSR 
area 


agBo 8285 LI RS, 6007 ** Clear out 7 words of the DSR area 
4612 пва? 

SS3B4 оағв CLR ERGt 

40B6 0605 DEC RS жж Done yet? 

48B8 16FD INE %->04 »48B4 ἘΚ Море?, do it again 

4686 O6AO0 BL 824112 ** бей VDPWA to beainning of PAB 
4ӘВС 4112 

4ØBE 0000 DATA >0000 

4σςσ 9205 LI RS5,»0090A Xx We're aoing to aet 18 bytes 
4σς2 SSSA 

48C4 C184 MOV R4,RS ἘΚ Put GPLWSP in Ré 

4σς6 0226 ΑΙ Ré, »ΕΕόΑ %Ұ%Ұ Point to DSR area in Scratch Pad 
4068 FF6A 

465Α DDAF MOVB @>FBFE (R15), #R6+ xx Move byte from РАВ to Scratch Ра 
4ӘСС FBFE 

абСЕ 0605 DEC RS жж Done Yet? 

4600 16FC JNE %->06 »48CA X nope?, Do it again 

4802 5920 3 SZCB QG»54051,G»5FFG6B(R4) XX Clear out bottom 5 bits of stat 
48D4 4051 X* byte. Set to defaults 

4606 FF6B 

40586 9824 СВ @>FFéA (R4) , @>484B ** Is this valid opcode? 

4868DA FFSA 

49DC 45648 

4ӘПЕ 1202 JLE %»206 >4дЕя XX Yes, then keep going 

адЕр 0460 В ве>426С xx Море!, Return ап error 

46Ε2 486C 

40Е4 D164 MOVB Θ)ΕΕόΑ(ίπΦ) , RS ** Put opcode in MSbyte of RS 

40Е6 FF6A 

40Е8 2985 SRL RS5,8 : XX Put it in low byte 

4664 BAIS SLA НБ5,1 *x Multiply it by 2 

4σες C165 MOV Ε)405Α(Π5).Β5 X3 Get address from opcode table 
46ΕΕ 495A 

адре 0455 В #RS X3 Jump to the correct opcode rtn. 


%% Open Opcode Routine ἈΚ 


490F2 DOA4 MOVB G»5FF6E(R4),R2 X4 Move @ DSR Logical length into 
48F4 ΕΕόΕ 

4gró 1689 JNE %ғ214 >410Ү4 ΑΧ If its not Ø then don't alter it 
460ғв @5А@ BL @>4112 *x Set up VDP pointer to logical 
AGFA 4112 ** lenath 

дөғс 49904 DATA >4004 

4ØFE 0202 LI R2,»51300 ++ 19 Chars for length 

41090 13988 

4102 0902 MOVB R2,G»5FF6E(R4) * Put it in DSR logical lenath byt 
4104 FF6E 

4106 DBC2 MOVB R2,@>FFFE(RIS) жж Put it in PAB logical length byt 
4108 ΕΕΕΕ 

410A DE64 MOVB ФОКҒӨВІК4), Кі #% Move status byte to Ri 

410C FFéB 

416Ε 2468 В @>48¢e0 ** Return 

4110 4080 


** This routine sets up the VDPUA for a read or write from the PAB. A ** 


xx data statement is passed and used as follows: 240 in MSByte is a ** 
XX write, 200 ің a read, LSByte is offset into PAB. ** 
4112 C964 MOV Q@>y,FF26(R4),R1 ** Put device pointer in R1 

4114 FF?6 


— 
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ἘΚ This routine is a delay routine. 
** number of times to execute the delay 


412A 
412C 
412E 
4150 
4152 


СӨ?В 
10002 
0621 
16FD 
g45B 
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MOV 
NOP 
DEC 
JNE 
RT 


ΣῈ Write Opcode 


4134 
4136 
4138 
413A 
413C 
413E 
4146 
4142 
4144 


casa 
FF6C 
g6A9 
4120 
D1E4 
FF&F 
2987 
2287 
2013 


μον 


BL 


MOVB 


SRL 
CI 


%% Get data from PAB for write 


4146 
4148 
414A 
414C 
414Е 
4156 
4152 
4154 
4156 
4156 
415А 
415С 
415E 
9162 
9162 
4164 
4166 
4168 
416A 
416С 
416Е 
4126 
4122 


D1AF 
FBFE 
g6Ce6 
Di1AF 
FBFE 
PIAS 
4652 
168Ε 
Φόςό 
096 
ΕΕΖΕ 
D92F 
FBFE 
FF82 
D92F 
FBFE 
FFS1 

D1AF 
FBFE 
1σσσ 
pear 
FBFE 
FF89 


MOVB 


SWPB 
MOVB 


CB 
JNE 
SwPB 
MOVB 


MOVB 


MOVB 


MOVB 


NOP 
MOVB 


Q»FF274(R4),R1 жж Subtract the device name length 
R1,»5FFF6 X4 Subtract 12 (Point to start 

++ of PAB) 
XR11+,R1 жж Add data statement to КІ 
ве>02003(84),Ж%815 *x Move LSByte of БІ into VDPWA 

Ұж Wait 
R1,X*R15 ЖЖ Move MSByte of ВІ into VDPWA 

ЖЖ Go back 

The data statement passed is the жж 
loop. ж 

XR11+,R1 * Get number of times to loop 

* Wait 
R1 * Done yet? 
Φ- 264 »412C ¥% No?, loop again. 

++ Go back 
Routine ЖЖ 
@>FFSC (RA) ,R1 ¥% Data Buffer Address Pointer 

ЖЖ into R1 
824120 X3X Enter in middle of sub to set 

) X VDPWA to the data buffer іп VDP 

G»FF6F((R4),R7 XX Move Chr count to MSbyte R7 
R7,8 ** Put it in LSbyte R? 
К?,>0015 Xx Compare to See if 19 bytes 

X44 Where's the Jump if Greater? 
Q»FBFE(R13),R6 ++ Get day of week 
R6 ++ Switch em 
Q»FBFE(t(R1S),R6 Xx Read another 
2›4252, Ró ЖЖ Check to see if it's a ',' 
$-»E2 24872 Xx No? Then return an error 
πό ** Put day back in High Byte 
Ró, @>FF7E(R4) жа Put it in DSR area 2835Ε 
G»FBFE(RA15),G0»5FF82(RÀ4) ΚΚ Get first digit of month 
G»FBFE(IRIS),QGDFFBGI1(R4) XX* Get second digit 
@>FBFE(R15),R6 *x Get rid of slash 

жж wait 
@>FBFE (R15) ,@>FFEG(RG) xx Get first digit of day 


MOVB 


MOVB 


NOP 
MOVB 


MOVB 


SRL 
MPY 


MOVB 


MOVB 


SOCB 


MOVB 


MOVB 


NOP 


MOUB 


MOVB 


MOVB 


NOP 


MOVB 


MOVB 


@›ЕРВРЕ‹К15),@›КЕ?Е (RÀ) 


@>FBFE(R15).Ré 


Θ)ΕΕΕΕ(ΒΙ5).Ρβό 
Ré,@>FFE4(R4) 


R6,8 
8)465ό,βό 


@>FBFE(R15),R5 
R5,@>FFE3(R4) 

R5,8 

R5,R? 

Ré 

@>4858,R6 

R7,R? 

**508 4144 
9»494B,G»FFGO (R4) 
Θ)ΕΒΕΕ(ΒΙ5),Ρό 


@>4852,R6 


%%206 24188 


е>аг>2 


@>FBFE (R15) ,@>FF7D(R4) 


C4344, C>FF7D (R4) 


@5FBFE(R15),@XFF72C (R4) 


@>FBFE(R15),R6 


Ώ»ΕΒΕΕΙΚΙΞ5), Θ»ΕΕΖΒΙΒ4) 


G»FBFE(R1S),QG»5FF2A(RA4) 


)ΕΒΕΕ(ΒΙ5),Ρό 


G»FBFE(R15),QG^5FF?9(RàÀ4) 


QG»FBFE(R15),Q0Q^5FF728(R4) 


жж 


** 
++ 


++ 


Get second digit of дау 


Get rid of slash 


wait 
Get first diait of vear 


Move it into DSR area 


Move it into 16 bits 
Multiply bv 10 


Get second digit of year 
Put it in DSR area 

Put it in 16 bits 

Add it to First digit x 16 
Set up for divide 

Divide by 4 

Check to see if а leap year 
It its not then jump 

Set bit 3 of first digit of 
byte 

Get the comma 


Is it a comma? 


Yes?, Keep going 
Report the error 


Get first digit of hour 

Set most sianificant bit of 
low nybbie 

Get second digit of hour 
Get rid of colon 

Wait 

Get first digit of minutes 
Get second digit of minutes 
Get rid of colon 

Wait 


Get first diqit of seconds 


Get second digit of seconds 


day 


the 


К 


b HE NE E алта. 


скининия к K O EE ΠΒ ΑΠ P 


' 


SECTION |: DSR ARCHITECTURE 
41EC ΕΕΖ8 
41EE 08206 LI Ré, AOSD 
41F9 авар 
41F2 C144 μον R4,RS 
41F4 0225 ΑΙ RS, >FF84 
41F6 FF84 
44158 22908 LI RG, 524g 
41FA 5040 
41FC D626  MOUB @>4g4D,*R8 
41FE айар 
4200 B6AS BL @>4124 
4282 412A 
4204 9918 DATA 20010 
4286 000% MOVB #85,85 
4208 0245 ANDI R3, eres 
428A ὅεσσ 
428C сісе πον Βό,Ββ2 
420Е 8687 DEC R7 
4218 GAB? SLA R?,8 
4212 ΕιΕσ 5058 @>494D,R7 
4214 4640 
4216 D687 MOVE R2,*R9 
4218 0865 MOVE Ε5,825σ0σ 
421A 5090 
421C 0242 ANDI R?,>4F00 
421E ағай 
4228 D687 MOVB R7, ¥Re 
4222 F1E@ SOCB @)494E,R7 
4224 484E 
4226 D697 MOVB R?,*R8 
4228 S1E@  SZCB 8»5404E,.R7 
422A 404E 
422C бе02 MOVB R?,*R8 
422E 0605 DEC RS 
4256 0606 DEC Ró 
4232 16E9 INE %->2С +4286 
4234 D696 MOVB Ré, #88 
4236 8448 В 8»4680 
4238 4089 


** Read Opcode Routine ++ 


423A 
4256 
423E 
4246 
4242 
4244 
4246 
4248 
424А 
4246 
424E 
4250 
4252 
4254 
4256 
4258 
425A 
425C 


0224 
сего 
C144 
0225 
FF84 
D928 
4049 
ЕЕЕ 
92068 
5040 
0620 
адар 
B6AR 
412A 
σσιθ 
0626 
4051 
CiCó 


LI 


μον 
AI 


MOVB 


LI 


MOVB 


BL 


DATA 
MOVB 


MOV 


R6,»0098D 


R4,RS 
RS, >FF84 


@>4849, @>FFSF (R4) 


R8, ›5249 
@>494D, ΧΚΘ 
8»412Α 


25612 
@>4951 , ΧΠΘ 


Rá, R? 


жж 


жж 
жж 
жж 
жж 


жж 


** 


жж 
жж 
жж 
жж 
жж 
ж 
++ 


ж 
жж 


жж 
жж 
жж 
жж 


x+ 
жж 


жж 
++ 
жж 
ж 
жж 
жж 


ж 


жж 


x+ 


15 Bytes to write 


Duplicate GPLWS in RS 
Point to 58364 in DSR area 
we want to put in clock) 
Point to enable bvte 


(bytes 


Enable the device 


Delay 219 times 


Move the byte into R3 

Mask out bits except for Low 
nybble of MSByte 

Copy R6 into R7 

Subtract one from R7 

Put it in hSByte 

Set Bits Ø and і of MSByte 


Move to enable byte 
Move to data byte 


Mask out bits 0,2 and 3 of MNSBvte 
and all of LSByte 

Move it to enable byte 

Set bit 3 of MSByte 


Move it to enable byte 
Clear all but bit 3 of MSByte 


Move it to enable byte 

Subtract one from pointer to data 
Done yet? 

Nope?, Do it again 

Disable write byte 

Go back! 


We're going to read 13 bytes 


Put GPLUSP in RS 
Point to 28564 іп DSR area 


Put 19 into chr count of DSR ar 


Enable Byte address in RS 
Put >C into Enable byte 


Delay 2102 times 


Let it know we're going to read? 


Сору R6 into R7 


SECTION : DSR APCHTELTURE Ep. IT 
425E 0607 DEC R? xx Subtract 1 
4260 @A87 SLA R7,8 +* Put it in MSByte 
4262 ΕΙΕΟ 6ОСВ @>4851,R7 ** Set J MSBits 
4264 4051 
4266 0607 MOVB R7,#RB ἘΚ Tell it we want another byte 
4268 1209 МОР **x Wait 
426A 1888 NOP 
426C DBES MOVB @>5995,R3 Xx Get numeric value from data byte 
426Ε 5000 
4276 FEES  SOCB @>494C,R3 жє Add ascii offset for numbers 
4272 абас 
4274 D543 MOVB К3,%К5 +* Move it into DSR area 
4276 0605 DEC RS ** Dec DSR area address pointer 
4278 02606 DEC R6 . Xx Done yet? 
4274 16F@ JNE  $-51E >425С X Море?, do it again 
427C D686 MOVB Ró, *R8 ¥% Put Ø into enable byte 
427E C64 МОУ @>FF6C(R4),RI +* Address to Pab Data butter 
4280 Εξός 
4282 J6Að BL @>411E x* Set up VDPWA 
4284 411E 
4286 4000 DATA >4000 ** Gonna write 
4288 5144 MOVB Q»5FF7E(R4),R6 xx Get Day of week from DSR area 
428A ΕΕΖΕ 
428C DBC6 MOVB R6,QG»5FFFE(R15E) x* Put it in Pab Data buffer 
428E FFFE 
4290 DBES MOVB 9›4052,0›ҒҒҒЕ (R15) +* Put a ',' in there! 
4292 4052 
4294 ΕΕΕΕ 
4296 DBE4 MOVB @›РЕВ2(К4),@›ЕЕРЕ(Е15) x* Move number of month in there 
4298 FF82 
429A FFFE 
429C DBE4 MOVB Θ)ΕΕΒΙ (Ρβ4),Θ2ΕΕΕΕ(ίΒΙ5) #%# Second digit of month 
429E FFB81 
42А0 FFFE 
42A2 DBEO MOVB GQ»49535,0G»5FFFE (R15) ++ Put in a '/' 
42A4 49053 
42A6 FFFE 
42A8 D1A4 MOVB @>FFBB(R4A) ,RS Xx Get the day number 
42АА ΕΕΘΒΟ 
42AC 8246 ANDI RG, 5560 ἘΚ Mask out anything greater 
42АЕ 5300 ++ ASCII 2 
4256 DBC6 MOVB R6,@>FFFE (R15) X* Put in PAB 
42B2 ΕΕΕΕ 
4284 DBE4 MOVB @>FF7F(R4) ,@>FFFE(RIS) #* Put in the second digit 
4286 FF?F 
4288 FFFE 
42BA DBES MOVB 8>4055,ФОҒҒҒЕ(БК15) ++ Put іп another '/', 
42ВС 4053 
42ВЕ ҒЕҒЕ 
42С0 DBE4 MOVB @>FFS4(R4),@>FFFE(RIS) X Put іп the year 
42C2 FF84 
42C4 ΕΕΡΕ 
42C6 DBE4 MOVE GDFF83(RA),GDFFFE(RIS) 334 Second digit of year 
42С8 FF83 
42CA FFFE 
42CC DBE9 MOVB @548952,@>FFFE(RIS) ++ Time for another ',"' 
42CE 49052 
42D8 FFFE 
4202 D1A4 MOVB QG^FF7D(R4),R6 Xx Get top digit of hour 
4204 ҒҒ?р 


in 


than 


"Ç à NM B WR > W че р w -η m” = πὶ π = 
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MOVB 


MOVB 


MOVB 


MOVB 


MOVB 


MOVB 


LWPI 


Ré, 3388 


Ré, @>FFFE (RIS) 


@>FF2C (84), @>FFFE(R15) 


@уа4а@54,@›ЕЕЕЕ(#1%5) 


@>FF7B(R4) ,.@>FFFE(RI5) 


Θ)ΕΕΖΑ(ίΠΦ),Θ)ΕΕΕΕΙ(ΠΙ5) 


ϐ)4054,Θ)ΕΕΕΕ(ΒΙ 95) 


G»FF29(R4)2),QG»FFFE(R15) 


С©ҒР?В (R4).@>FFFE(R15) 


Β»4666 
8398 


8»456ς 


жж 


xx 


жж 


жж 


++ 


++ 


++ 


HE 


жж 


жж 


++ 


++ 


жж 
жж 


Mask out anything greater than 
ASCII 3 

Put it in PAB 

Put in second dioit of hour 
Put in а 


Put in Minutes 


Put in second digit of minutes 


Put in seconds 


Put in second digit of seconds 


Go back 


Load GPLWSP Test routine 
perhaps? 
Keep looping??? 
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2.4 Subroutine links 


Subroutine links (also known as low level routines or BASIC CALL 
subprograms) are the least documented program types available on DSRs. 
However, they offer the possibility of adding powerful new features to 
BASIC and XBASIC on the /4A system. Subroutine links may be of two 
types: low level routines or BASIC subprograms. Low level routines 
may be accessed via DSRLNK with a DATA >A (instead of 28) statement, 
as shown in the example code. Low level routines are not accessed by 
the FMS in the console, as are the main device routines. BASIC 
subprograms (ie- CALL FILES(x)), are accessed from the command mode of 
BASIC or XBASIC, and from running BASIC programs. The search DSR 
routine for subprograms in XBASIC searches only GROMS апа not 
peripheral ROMs when the XBASIC program is running. Both of these 
routine types can be included in peripheral DSRs to enhance or add 
features not available in other applications. An example of this is 
the Disk Drive Controller which has seven low level routines for 
disk/file access and adds "CALL FILES(x)" to the BASIC environment. 
Each of the two routine types is discussed further below. 


2.4.1 Low level routines 


Low level routines are accessed only by DSRLNK. Тһе PAB values 
to be set are name length (1 byte) and the routine number (>10->FF). 
The low level routine may use registers RO - R10. Registers R11 - R15 
have the previously defined meanings. Upon entry into a low level 
routine, R11 should be saved. Data or parameters may be passed 
through the FAC RAM area or at a known offset in the VDP from the PAB. 
The low level routine must include an error reporting subroutine that 
places the 3 bit error codes used by main device routines in byte 
28350. Table 1.2 lists the memory locations and contents. 


TABLE I.2: LOW LEVEL ROUTINE PARAMETER ADDRESSES 


Address Contents 

>834А (FAC) data 1/0, parameter passing 

834B Š 

834C Е 

8340 Š 

834E " 

834F " 

8350 MSB contains error codes upon return 
8352 data 1/0 


It is the responsibility of the application program to prepare 
data for transfer in the available addresses, prepare for the DSRLNK, 
and read the error codes and any other data in the 2834А-28352 
addresses returned by the DSR. Example 1.48 lists partial code for a 
low level routine. Example I.4b lists partial code for accessing à 


ZA EM . тит 


аг W 


M 


X 


ьи É RE- Бо ΝΠ. 


“ ú ú s 


1 


ж = 


low level routine. Low level routines can be used in conjunction with 
an application program to add utility or special purpose functions 
that: 1) require speed (in assembly instead of BASIC), and 2) аге 
versatile enough for use in more than one program, thereby justifying 
inclusion in ROM. 


SECTIO йе " 
EXAMPLE 1.4а: LOW LEVEL ROUTINE 

AORG 24000 

BYTE >AA Р 

ВҮТЕ 1 E 

DATA 20000 

DATA ---- 

DATA 20000 E 

DATA ---- 

DATA 11810 link to 1st low level routine 

DATA --- 

DATA »0000 | 
LLRIO РАТА LLR2O link to 2nd low level routine Q. 

DATA LLR10E entry point of 1st low level routine ! 

ВҮТЕ 1 name length 

ΒΥΤΕ 210 low level routine number у. 

ΕΝΕΝ 3 
LLR2O DATA >0000 no more low levels 

DATA LLR20E entry point for 2nd low level routine k 

BYTE 1 E 

BYTE »20 low level routine number 

EVEN ч 
LLRIOE $ entry point of low level ›10 = 
LLR20E $ entry point of low level >20 / 
ERROR [set 3 MSbits of >8350] im 
ERRTN B *R11 return k 
RETURN INCT R11 

B *R11 


ΕΕ ο K E K R ЫЙ 


SECTION |: DSR ARCHITECTURE 


PAB 
DATBUF 
PABPTR 


ACCESS 


RETURN 


EXAMPLE I.4b: LOW LEVEL ROUTINE ACCESS 


DEF ACCESS 


REF DSRLNK,VMBW 


DATA 20110 
EQU 21000 
EQU »0F80 


LI В0,2ХХХХ 
MOV R0,62834A 


LI RO,PABPTR 
LI R1,PAB 

LI R2,2 

BLWP @VMBW 
MOV RO,@>8356 
BLWP @>DSRLNK 
DATA 2А 


name length 1, routine 210 
pointer to data buffer in VDP RAM 
pointer to PAB in VDP RAM 


load data for transfer 

put in 1st address 

(load other data in FAC if needed) 
put PAB in >OF80 of VDP 


2 bytes to write to VDP 
write PAB to VDP 

put pointer to РАВ іп 28356 
access to low level 


[check >8350 for error bits] 
[recover data in FAC] 


B *R11 
END 


return 


[SECTION 1: DSR ARCHITECTURE eur 


2.4.2 BASIC CALL subprograms 


BASIC CALL subprograms are accessed from BASIC or XBASIC, and not 
through the FMS. Because of this, special care must be taken in 
interaction between the 'assembly' environment of the DSR and the 
'GPL' environment of BASIC. Тһе header for CALL subprograms is 
Similar to that of low level routines. Errors may be returned by 
setting the BASIC token value at 28342 to 207. This will return an 
"INCORRECT STATEMENT" error іп the BASIC program. DATA may be 
transferred from the BASIC environment by this program type (for 
example, CALL FILES(1)). The subprogram must manipulate the BASIC 
token pointer (283260) and the current token (28342) to retrieve data 
and reset the current BASIC line token before returning to GPL. Other 
error bytes must be checked and cleared prior to returning also. The 
routine is responsible for keeping track of the current token pointer 
position, and adjusting it as needed. 

CALL subprogram routines may use the registers as defined for the 
low level routines. Errors can be returned as INCORRECT STATEMENT. 
The routine should not utilize GROM access, as this may disrupt GROM 
address settings assumed by the BASIC calling program. If GROM access 
is required, then the GROM address should be saved and then restored. 
As with all DSR accesses, it is the responsibility of the programmer 
to ensure that the routine does not disrrupt the BASIC/XBASIC 
environment while executing, or upon its return. Figure I.3 is a 
flowchart of a CALL subprogram. Example 1.5 demonstrates how a 
routine may be coded. The disassembled and commented CALL FILES of 
the Disk Drive Controller (from "Technical Drive") is also included. 
More documentation on these routines is available in the source code 
and technical manual for the Horizon RAMdisk. The source code file 
for the original version of the RAMdisk ROS section of CALL subs is 
also included, and demonstrates how to recover input parameters from 
the BASIC environment, and handle errors. 
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FIG. 1.3: CALL SUBROUTINE 


save return address 
save token pointer 

adjust token pointer 
to skip to end of line 


clear 28342 to 
line value (2002 


recover return address 
send token value back 
to VDP 

reset token pointer 
clear floating pt. byte 
R11 = RII + 2 
return via R11 


CALL sub routine 


end of 


PG 124 


CALL 1 


CALL2 


CALLIE 


CALL2E 


ERROR 


OKRTN 
EXIT 


EXAMPLE I.5: CALL SUBPROGRAM 


AORG 24000 

BYTE >AA 

BYTE 1 

DATA »0000 

DATA ---- 

DATA »0000 

DATA ---- 

DATA CALL 1 link to 1st CALL sub 

DATA ---- 

DATA 20000 

DATA CALL2 link to 2nd CALL sub 

DATA CALL1E entry point to 1st CALL sub 
BYTE 3 name length 

TEXT “ЕРТ! name of routine 

EVEN 

DATA 20000 no more CALL subs 

DATA CALL2E entry point of 2nd CALL sub 
BYTE 5 name length 

TEXT 'MACRO' name of routine 

EVEN 

$ entry point of 1st CALL sub 
MOV R11,R7 save return address 

MOV @>832C,R8 put token pointer in R8 

АІ R8,3 add name length to get to end of line 


[routine for ЕРТ] 


B @ERROR only if error 

B GOKRTN return with no error 

$ entry point of 2nd CALL sub 

MOV R11,R7 save return address 

MOV @>832C,R8 put token pointer in R8 

AI R8,5 add name length to get to end of line 


[routine for MACRO] 


B ERROR only if error 

В @OKRIN return with no error 

LI RO,>0700 incorrect statement token 

MOVB В0,6>8342 put it in current token address 
JMP EXIT 


SZCB 6828342,828342 makes end of line (200) current token 


MOV R7,R11 


recover return address 


É E E E” F Y E F E Z ús E W. FE 


ἄλλα τα EERE 108 ἢ 


[SECTION |: DER ARCHITECTURE 00 — PG ρε 
MOV R8,R1 set token pointer 
SWPB R1 LSB first 
MOVB R1,@>8C02 move to VDP write 
SWPB R1 


MOVB R1,@>8C02 
MOV R1,@>832C 
INCT R11 

SZCB »4000,858354 
B *К11 

END 


MSB next 

reset token pointer 

no other errors 

clear floating point error 
return 


SECTION |: DSR ARCHITECTURE WOƏII PIZ 


*BASIC CALL FILES ROUTINE FOR THE TI DISK DRIVE CONTROLLER* 


ë 
Ë 
Ё 
b 
P 


AORG >5D5A 
Μον R11,R7 *save return address 5D5A 
BL @>4724 *Init routine 5D5C 
MOV @>002C(R9),R8 *token code pointer in R8 5D60 
АІ Е8,>0007 *add 7 to skip !FILES(! 5D64 
BL 054876 *get 2 bytes afer it 5D68 
CI RO,>C801 *check for unquoted string, 5060 
*length of 1 (tokenized code) 
JNE AA *no?, then jump 5D70 5 
INCT R8 *point to ASCII # 5D72 I 
BL @>4B76 *get it from VDP 5D74 
SWPB RO *put ASCII # in low byte, 5D78 
*)B6 in high byte b 
АІ RO,>49D0 *mask out ASCII offset 5D7A Г 
СІ ВО, ›0009 *check if non-numeric 5D7E 
JH >5DAA *yes? then jump 5D82 d 
SWPB RO *put # of FCB's to reserve 5D84 - 
*in MSByte 
MOVB RO,@>004C(R9) *put it іп >834C for 216 return 5D86 : 
BL 824658 *do routine 216 (reserve buffers) | 5D8A e 
DATA »5DB4 5D8E 
MOVB @>0050(R9),@>0050(R9) *error? 5D90 F 
JNE >5DAA *yes? then jump 5D96 d 
MOV @>002C(R9),R8 *put token pointer in R8 5D98 i 
ΑΙ R8,>000C *point to end of statement 5D9C 
Μον R8,0>002C(R9) *put it in token pointer 5DAO 
SZCB @>0042(R9),@>0042(R9) *put 200 at 28342 (current token) 5DA4 
*(end of statement indicator) 
B @>4676 *return 5DAA 
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* * * * * * + * * * + + k k k k k k k * K * * * * + k k k ΧΆ k k * k *k k * * * * k k Ακ 


t+ + + + + + + 


RAMDISK OPERATING SYSTEM 
COPYRIGHT 1985, HORIZON COMPUTER, LIMITED 


-- ALL RIGHTS RESERVED -- 


+ + + ЖЖЖ 


κ * *  * * + * k * KKK KK * * * * * * ХХХ 


ж 


ж 


* This code consists of all of the CALL sub-* 
* programs accessable from TI BASIC and $ 
* Ext. BASIC command mode except for CALL DM* 
* The code resides in the second 2K block. * 


* 


* 


kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk 


* 


AORG 25800 
МТРА EQU 2415Е 
МАХЅЕС EQU 24010 
5У1 EQU >419A 
ТЕМ EQU 24100 
0МЕ EQU 24000 
SVADR EQU >41AA 
FAC EQU ›834А 
DRIVE EQU >400E 
FCB EQU 24108 
SAVADR EQU 241А8 
VRWA EQU >4290 
VDPRD EQU ›8800 
FCBDIF EQU 24104 


NUMDRV EQU 
* 


24014 


ж 
* CHANGE DRIVE NUMBER 
* 
ж 


DRCNG MOV 
MOV 
AI 
BL 
MOV 
JEQ 
B 

DRNO1 A 
MOV 


R11,@SVADR 
@>832C,R1 
R1,4 

@CLRD 

@FAC+2 ,@FAC+2 
DRNO1 

@DRERR 
@FAC+4,R1 
@FAC,R2 


GET TOKEN POINTER 

POINT TO TOKEN FOR TRANSFER 
CALL ROUTINE DIGIT READ 
ERROR? 


DRNO2 


DRNO3 


DRNO4 


DRNOS 


DRNO6 
DRERR 


CALLRT 
CALLER 


DROPEN 


DROP 1 


828800, RO 
R1 

RO 
Ε»8800, RO 
RO, 182 
DRNO4 
@DRERR 
@DRIVE+1,RO 
@DROPEN 
@FCB,@FCB 
DRNO5 
@DRERR 
R2,RO 

RO 
@DROPEN 
@FCB,@FCB 
DRNO6 
@DRERR 
R2,8DRIVE 
CALLRT 
К0,20700 
К0,858342 
CALLER 


@>8342 ,@>8342 


@SVADR,R11 
Ri 


R1,*R15 
R1,@>832C 
R11 


@>4014,@>8354 


*R11 
R11,R9 
@>8370,R8 
R8,6 
R8,@FCB 
R8 

@VRWA 
@VDPRD , R4 
R4,8 
@FCB,R8 
R8,5 
@VRWA 
@VDPRD,R5 
R5.,RO 
DROP3 


<7? 


GET PARENTHESIS AND EOL BYTE 
R1 POINTS TO EOL BYTE 


RIGHT PAREN? ) 


RE-LOAD WRITE REGISTER 
RESET TOKEN POINTER 


RETURN 


MAX # OF OPEN FILES 


DRIVE # 
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MOVB @VDPRD,R3 
JEQ DROP3 
B *R9 
DROP3 A @FCBDIF , GF CB 
DEC R4 
JNE ΡΚΟΡΊ 
CLR @FCB 
B *R9 
* 


* SET MAXIMUM SECTOR SIZE 
* 


MAXSC MOV R11,@SVADR 
MOV @>832C,R1 
АІ R1,4 
BL @CLRD 
МОУ @FAC+2,@FAC+2 
JEQ МАХ01 
B @DRERR 
MAX01 A @FAC+4,R1 
MOV @FAC,R2 
JGT МАХ02 
B @DRERR 
МАХО2 CI R2,1441 
JLT MAX03 
B @DRERR 
MAXO3 MOVB @>8800,RO 
ІМС R1 
SWPB RO 
MOVB @>8800,RO 
CI RO,182 
JEQ МАХО4 
B @DRERR 
МАХО4 ΜΟΝ R2, @MAXSEC 
Β @CALLRT 


* CALL EXECUTE ROUTINE 
* 


EXCUT MOV R11,@SVADR 
MOV @>832C,R1 
АІ R1,4 
BL @CLRD 
MOV @FAC+2,@FAC+2 
JEQ ЕХО1 
B  @DRERR 
EX01 A ΘΕΑΓ14,ΒΊ 
MOV R1,@>8300 
MOV @FAC,R2 
BL *R2 
LWPI >83E0 
MOV @>8300,R1 
SWPB R1 
MOVB R1,*R15 


1ST CHAR FILE NAME 


GET NUMBER 
ERROR? 


GET PARENTHESIS AND EOL BYTE 
R1 POINTS TO EOL BYTE 


RIGHT PAREN? ) 


ECTURE 


п DSR ARCHIT 


SWPB R1 

MOVB R1,*R15 

INC RI 

MOVB €>8800 , RO 

SWPB RO 

MOVB 8»8800,R0 

CI  R0,182 

ЈЕО ЕХО2 

В @DRERR 
X02 В @CALLRT 


READ A NUMBER FROM THE CALLING PROGRAM 


R1 - POINTS TO THE STRING DESCRIPTOR TOKEN 
RO-R3 ARE USED 


FAC RETURNS THE INTEGER 

FAC+2 0 FOR NO ERROR, 1 FOR ERROR 
ҒАС-4 NUMBER OF TOKEN POINTER MOVES 
FAC+6 TEMP STORAGE OF ΑἹ 


| 
* 
* 
* 
* 
* 
* 
ж 
ж 
ж 
ж 
ж 
ж 


VOPWA/R1 LEFT POINTING TO NEXT CHAR/TOKEN 


CLRD | MOV К11,65У1 
CLR @FAC 
CLR @FAC+2 
CLR @FAC+4 
MOV R1,@FAC+6 
SWPB Ri 
MOVB R1,*R15 
SWPB А1 
MOVB Ri,*R15 
CLR Ri 
MOVB @>8800,R1 CHECK TOKEN FOR UNQUOTED STRING 
INC @FAC+4 
CI  R1,»C800 
JEQ NMI 
B @NMERR IF NOT, RETURN AN ERROR 
ΝΜΊ ΜΟΝΒ @>8800,R1 CHECK NEXT BYTE FOR LENGTH OF STRING 
ІМС GFAC«4 
SRL Ri,8 
MOV R1,R1 
JGT NM? »0? 
B @NMERR 
NM2 CI RIi,7 <7? 
JLT NM25 
B @NMERR 
NM25 MOVB @>8800,R2 CHECK FOR MINUS SIGN 
INC @FAC+4 
SRL R2,8 
CI R2,>002D 
JEQ NM27 
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NM4 μον 


NM5 DEC 


NM6 MOV 


NM7 CLR 


* 


* RETURN TO 
* 


NMERR MOV 

NMRTN MOV 
MOV 
B 


* 


R1,6 ARE THERE «6 DIGITS? 
NM35 

@NMERR 

@TEN,@FAC+2 

NM35 

@>8800,R2 READ A DIGIT 
@FAC+4 

R2,8 

R2,-48 

@NMCK A VALID DIGIT? 
RO,RO К0-0 IF 0-9 

NM4 

@NMERR 

R2,R2 IS DIGIT 0? 

NM6 IF SO, SKIP MPY 
R3 

R1, RO COUNTER FOR MPY 
RO 

NM6 DONE? 

@TEN,R2 


R1 MORE DIGITS? 

NM3 

@FAC+2,@TEN NEGATIVE NUMBER? 
NM7 

@FAC 

GFAC«2 

@NMRTN 


INTERNAL CALLER 


GONE , @FAC+2 
@SV1,R11 
@FAC+6,R1 
*R11 


* CHECK DIGIT 
* 


NMCK LI 
MOV 
JLT 
CI 
JGT 
CLR 

NMR B 

* 


RO,1 
R2,R2 
NMR 
R2,9 
NMR 
RO 
*R11 


* PROTECTION ON 
* 


WRPON MOV 


R11, @SVADR 


* 


Μον 
MOV 
AI 

JMP 


QONE , ΒΝΤΡΕ 
@>832C,R1 
R1,2 

WPNO1 


* PROTECTION OFF 
ж 


WRPOFF 
WPN01 
* 


* CARD 
* 
CON 


COFF 


* 


MOV 
CLR 
MOV 
AI 
B 


R11,@SVADR 
@WTPR 
@>832C,R1 
81,2 
@CALLRT 


CRU ON/OFF 


INCT 
Μον 
Μον 
ΑΙ 
JMP 
MOV 
MOV 
AI 
JMP 


R11 
R11,@SVADR 
€>832C,R1 
R1,2 

WPNO1 
R11,@SVADR 
85832C,R1 
R1,2 

WPNO1 


* SET NUMBER OF DRIVES 1-4 
* 


SETNDR 


STDRNi 


STDRN2 


STDRN3 


STDRN4 


MOV 
MOV 
Al 
BL 
MOV 
JEQ 
B 

A 
MOV 
JGT 
B 

CI 
JLT 
B 
MOVB 
INC 
SWPB 
MOVB 
CI 
JEQ 


R11,@SVADR 
@>832C, КІ 
R1,4 

@CLRD 

@FAC+2, @FAC+2 
STDRN1 

@DRERR 
GFAC44 βΊ 
GFAC,R2 


STDRN2 20? 


@DRERR 


R2,5 <5? 


STDRN3 
@DRERR 
828800, RO 
R1 

RO 
828800, RO 


R0,182 RIGHT PAREN? ) 


STDRN4 
@DRERR 
R2 , GNUMDRV 
@CALLRT 


TETIEEEE$EEIS EE EFF ü G EYE 


SECTION J: DSR ACCESS 


1.0 Introduction 


The purpose of this section is to demonstrate how the console can 
access DSRS. Subsection 2.0 outlines how the console accesses 
interrupts, power up (initialization) routines, BASIC subroutine links 
(CALL xxx), and access of main device routines as files. Subsection 
3.0 provides a simple DSRLNK routine in assembly for use with XBASIC 
(which does not load the DSRLNK routine as does the Ε/Α cartridge). 
This is also provided as an example of DSR access programming for 
application programs. 


= w w w w 


2.0 Console DSR Access 
2.1 Interrupt access routine 


The interrupt access routine 1s discussed first because it is a М 
stand-alone 9900 assembly routine located іп the console ROM; other 
DSR access routines in the console are also in ROM or in GPL in GROMS , 
0-2. The interrupt access routine flowchart is shown in Fig. 2.1. i 
The disassembled and commented source code is given in Fig. 2.2. 

Commonly used address EQUates are given in Table J.1. 

Upon entering the routine due to the detection of a low signal on % 
the -INTREQ line, all interrupts аге disabled to prevent further 
activation until the current interrupt is serviced. The GPL workspace i 
is loaded, and the CRU register (R12) is cleared. The cassette and P 
VDP interrupts are checked first. Then R12 is initialized and all 
peripherals from 21000 to 21Ғ00 are checked. If no peripheral caused 
the interrupt, the CPU returns to the main program. When searching 1 
the DSR, the routine checks for the header "AA" at byte 24000, then 3 
checks for the first interrupt routine. If there is an interrupt 
routine, the CPU will first save the next interrupt routine address in 
RO, and execute the current interrupt routine. Όροι return from the É 
first interrupt routine, the CPU will continue to execute subsequent 
interrupt routines until none are found for that peripheral. 
Therefore, any peripheral may have an interrupt routine (if needed), F. 
and each peripheral may have multiple interrupt routines. It is the 3 
responsiblity of the individual peripheral to determine if it has 
caused an interrupt, and reset it when the routine is complete. А11 Ë 
DSR interrupt routines are accessed whether or not they caused the E 
interrupt, even after the one that caused the interrupt is found. 


2.2 GPLDSR access routine 


Access by the console to other DSRs is via routines in GPL in the 
console GROMs or assembly in the console ROMs. Each of these access Ë 
routines (power up (ROM), CALL subprogram and main device/files 
(GROM)) use a routine referred to as GPLDSR. The GPL interpreter 
accesses this assembly language subroutine via an XML219 command. The -B 
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FIG. 2.21: INTERRUPT ACCESS ROUTINE 


INTIALIZATION: 
disable interrupts, toad GPL 
workspace, clear R12 (CRU) 


y 
is it a cassette interrupt? В 621404 
y 
Is it o VDP Interrupt? JNE @>094A 


initialize Rie to 20Ε00 
Ccounter value for search? 


clear CRU bit 0 


ada >0100 to R12 counter 


compare ΚΙΦ to 52000; end? > В e»0ABS 


End routine: 20488 ->0АВЕ 
clear R8 (search pointer) 
load WP to INTWS 

RTWP - end of interrupt 


turn on CRU bit 0 


compare byte >400C to “АА” 
is it the same? 


move byte >400C to AA 
(next int. routine in DSR) 


— — FV 


is it non-existent? 


Save next int. routine 
address in RO 


get int. routine address 
in RO 


INT. ROUTINE IN DSR 


recover next Int. routine 
from RO 


BRE πα EER EE 


| u! 
\ 
| 


SECTION J: DSR ACCESS 


FIGURE J.2.2: INTERRUPT ACCESS ROUTINE CODE 


AORG 20900 
0900 
LIMI >0000 *disable interrupts 0900 
LWPI 283Е0 *load GPLWS 0904 
CLR R12 *clear CRU register 0908 
* 
СОС 820032,814  *is it the cassette int.? 090A 
JNE NOCAS *no, jump 090E 
B @>1404 *jump to cassette routine 0910 
* 
NOCAS ΤΗ 202 *is it the VDP int.? 0914 
JNE AB *yes, jump to routine 0916 
* 
LI RI2,>0F00 *load initial search value 
SBO 200 *turn on card 091С 
ж 
LOOP «ΒΖ 200 *turn off card 091E 
AI R12,20100 πασά 20100 to search reg. 0920 
* 
CI | R12,»2000 *are we at the end? 0924 
JEQ END *yes, jump to end 0928 
* 
SBO >00 *turn card on 092А 
ж 
CB @›4000,@›0000 *check for valid "AA" header 0920 
JNE LOOP *no, start over 0932 
* 
MOV @>400C,R2 *save entry addr. in R2 0934 
* 
NXTDSR JEQ LOOP *no address, start over 0938 
* 
MOV R2,RO *save next addr. in RO 093A 
Μον @>0002(R2),R2 *get addr. for routine 093C 
* 
BL  *R2 *branch and link to ISR 0940 
* ый 
МОУ *RO,R2 *recover next ISR addr. 0942 
JMP NXTDSR *check and execute 0944 
ж 
END B @>0AB8 *end, return 0946 
ND 
MEC ο πμ 
AORG 20ΑΒ8 
CLR R8 *clear ROM search pointer ОАВ8 
LWPI 28360 *load WP to INTWS OABA 
RTWP *return OABE 
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GPLDSR routine starts at 20АС0 and runs to 20820 in the console ROM. 
Although similar to the interrupt access routine, it is used only from 
the GPL environment. The purpose of GPLDSR is to search all DSRs, 
find and execute the requested routine type as needed. Since the 
remaining DSR access routines utilize GPLDSR, it is outlined first. 

Figure 2.3 is the flowchart for GPLDSR. Initially, R1 is cleared 
and is used as a DSR version counter. R2 is used as storage for the 
address table value. 28300 is a predefined ROM/GROM address which may 
be set by the calling routine if the peripheral location is already 
known. 28302 is used to save the program address while 2836D has ап 
increment, or table jump value set by the calling program to instruct 
GPLDSR which address table value in the DSR to branch to. 

Upon entry into GPLDSR, R1 is cleared and CRULST is checked. If 
a non-zero value is given in CRULST (ie, the peripheral CRU value is 
known, and does not have to be searched for), then the routine 
branches to that peripheral CRU value directly. If CRULST is zero, 
then the GPLDSR routine steps through each peripheral (21000 - 21Ғ00), 
and checks for "AA" on the first byte. It then gets the first table 
entry value, and checks to see if it is non-zero. If non-zero, the 
address is saved in 28302. Тһе program entry point is stored іп R9. 
The name of the routine being searched for is checked by the routine 
NAMEMATCH (Section 2.2.1). If there is no match, the search routine 
continues. If there is a match, R1 is incremented, and the routine is 
executed by a BL *R9. When GPLDSR is complete, it branches to a 
subroutine 820842 which changes the value of CRULST before returning 
to the calling routine. If no matches are found іп апу peripheral, 
GPLDSR branches to an error handler at 2006A. 


2.2.1 NAMEMATCH routine 


The NAMEMATCH routine is at >OBE8 - 206008 in the console ROM, and 
is used by either ROMs or GROMs to match device names. CPU RAM 28354 
is SCLEN, and the device name length; 2834A is ΝΒΑ, the name buffer 
address (see Figures 2.5 and 2.6). 

Upon entry into NAMEMATCH, the device name length is retrieved 
from SCLEN and placed into R5 where it is used as a counter. If it is 
zero, then the CPU returns to the calling routine. The value of R5 is 
compared to the value given by the address in R2; if not equal then a 
return is made directly via R11, indicating a problem. If the length 
is OK, then R5 is adjusted to the right byte, and R6 is loaded with 
the name buffer address (ΝΒΑ). Next, NAMEMATCH checks to see if it is 
searching а GROM. If not, the counter value of R2 is incremented. 
The character (byte) pointed to by R6 is compared to that pointed to 
by R2. If not equal, a return with error is made. If the characters 
match, the loop continues until all characters are checked. If the 
device name length is correct and all characters match, then R11 is 
incremented by 2 (indicating no errors on return) and the CPU returns 
to the calling routine. 


2.3 Power up (initialization) access routine 


The power up access routine is in GPL in GROM O at 20188 (Figure 
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FIG. J.2.3: GPLDSR ROUTINE 
Initialize: clear counter 
(R15 version of DSR 
У/ move CRULST into R12. if check NAMEMATCH 
non-zero, jump to SEARCH 
error - no match EE 
load R12 with initial volue 
n LOOP: check ond see if 
anything in CRU needs to 
be turned off 


DSR 
ROUTINE 


return from DSR not there; | 
jump to SEARCH 
NSTRIM: next ROM (R12 + 


20100) clear CRULST іп созе 


it is finisheq DK return turn off CRU 
jump to CHGRM 


y up 
finished search? CRU=>2000 


clear *R8 E 


OK match, RI=R1+1 


execute routine 
BL «RQ 


save address of nex RU; 
turn on ROM 


CHGGRM: branch and link 
to routine to change 
ROM value 


check first byte for АА? 


go to first program pointer 
Jump to ENDDSR 


SEARCH: continue where we 
left off; turn RDM back on 


END! return to GPL 


ENDDSR: Is program pointer 
zero? if yes, then finished). 
Jump to LODP 


save address in 28302; go 
to progrom entry point ond 
get oddress 
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EFI BEB ER GEA 


NXTROM 


* 


* 


SEARCH 


* 


ENDDSR 


* 


AORG 
CLR 


MOV 
JNE 


LI 


MOV 
JEQ 


SBZ 


ΑΙ 
CLR 


CI 
JEQ 


μον 
580 
LI 


CB 
JNE 


AB 
JMP 


MOV 
SBO 


MOV 
JEQ 


MOV 
INCT 
MOV 
BL 
JMP 
INC 
BL 


JMP 


FIGURE J.2.4: GPLDSR ROUTINE CODE 


»0ACO 
R1 


@>83D0,R12 
SEARCH 


К12,20Ғ00 


R12,R12 
NXTROM 


»00 


R12,>0100 
@>83D0 


R12,>2000 
END 


R12,@>83D0 
»00 
К2,24000 


*R2,8»000D 
LOOP 


@>836D ,@>83E5 
ENDDSR 


@>83D2 , R2 
200 


*R2,R2 
LOOP 


R2,@>83D2 
R2 
*R2+,R9 
@>0BE8 
SEARCH 

R1 

*R9 
SEARCH 


*clear counter R1 


*get ROM search pointer (CRULST) 


*if none, jump to SEARCH 
*load initial value 


*check CRULST 
*if none, jump to NXTROM 


*turn off card in case done 


*add 20100 to CRULST 
*clear search pointer 


*at the end? 
*yes, jump to end 


*move R12 into CRULST 
*turn on card 
*set R2 to 24000 (ROM addr) 


*valid "AA" header? 
*no start over 


*calculate program entry addr. 


*jump to ENDDSR 


*move save addr. into R2 
*turn on card 


*no entry address given? 
*start over 


*move R2 into save addr. 
жада 2 to R2 

*point to name 

*check name via NAMEMATCH 


*error, no match return 


*0K return, increment version no. 


*execute routine 


*return if wrong peripheral 


OACO 
ОАСО 


ОАС2 
OAC6 


OAC8 


OACC 
OACE 


OADO 


OAD2 
OAD6 


OADA 
OADE 


OAEO 
OAE4 
OAE6 


OAEA 
OAEE 


OAFO 
OAF 6 


OAF8 
OAFC 


OAFE 
0800 


0802 
0806 
0808 
0В0А 
OBOE 
0B10 
0B12 


0B14 
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SBZ 200 *correct peripheral return, turn 
off card 
JMP CHGGRM *jump to CHGGRM 0818 
ж 
CLR *R8 *return for other routines 0ΒΊΑ 
CHGGRM BL 8520842 *change ROM search value routine 0В1С 
* 
END B @>006A *return to GPL 0820 
END 


R1» DSR version number 

R2- address table value 

»83D0- predefined ROM/GROM value 

28302- save address 

»836D- jump increment for DSR entry table 
>83E5= R2 LSB 


= η». ш 


i 


ΒΩ ΝΒ 
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FIG. 2.2.9: NAMEMATCH ROUTINE 


get nome length, use as 
о counter (RO) 


y 
IÉ length = 0, don't do match 


compore nome length with 
volue іп R2; no match? return 
to END 


odjust R5 counter to right 
byte 


load R6 with Name Buffer 
Address 


COMPARE: are we searching 
a GROM? 


Re=Re+1 KGRDMs don't need 
to increment? 


is character correct? if not 
exit to END 


counter = counter - 


is the counter > 0? return 
to COMPARE 


MATCH: finished, match DK, 
return 


| END: return, no match 
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* 


COMPAR 


* 


* 


CHKCHR 


* 


* 


ENDOK 
* 
ENDBAD 


FIGURE 9.2.6: NAMEMATCH ROUTINE CODE 


AORG >OBE8 

MOVB @>8355,R5 *get name length, put in R5 for 

JEQ ENDOK *END if zero 

CB  R5,*R2 *compare name length with value in 
R2 

JNE ΕΝΡΒΑΡ *END if bad 

SRL R5,8 *adjust to right byte 

LI R6,>834A *put NBA in R6 

CI R2,»9800 *searching a GROM? 

JHE CHKCHR *yes, jump 

INC R2 *no, this is ROM, increment addr by 
1 

CB «βόε, ΒΘ *compare characters 

JNE ENDBAD *no match, end bad 

DEC R5 *counter=counter-1 (R5) 

JNE COMPAR *keep going 

INCT R11 *good return 

B *R11 *error return 

END 


0ВЕ8 
OBES 
OBEC 
OBEE 
OBFO 


ОВЕ2 
OBF4 


OBF8 
ОВЕС 


OBFE 
000 
0002 


0С04 
0606 


0C08 
OCOA 
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2.7 and 2.8). This will cycle through all peripherals and execute any 
power up routines found. The power up access routine clears CRULST 
(>83D0) since a specific device or subprogram name is not being 
searched for, and SCLEN (28354) is also set to zero. A jump value of 
>04 is stored at 2836D to tell GPLDSR where to start in the DSR access 
table. Then a branch to XML 219 (GPLDSR) is made. This access 
routine is made very early during the power up sequence and allow 
initialization of the peripherals before they are accessed by the 
console. 


2.4 CALL subprogram access routine 


When a CALL subprogram is executed from a running BASIC program, 
or in the command mode of BASIC or XBASIC (DSRs in peripheral ROMs are 
not searched by XBASIC programs during execution), then the GPL code 
at ›500В - 25110 is executed (see Fig. 2.9 and 2.10). First, >830С 
is cleared, and the contents of 78300 are set equal to those of 28356. 
The CPU checks to see if the subprogram is in GROM or ROM. If in ROM, 
a CALL 6820010 is executed, and the GPL DSRLNK routine is accessed. А 
data value of 20Α is used as a jump value for proper entry in the DSR 
address table. 

Тһе GPL DSRLNK routine is at 203006 - 20415; the flowchart is 
shown in Fig. 2.9. Upon entry, the jump value is recovered and put 
into 28360. Тһе MSB of the SCLEN (28354) is cleared and the 
device/subprogram name length is placed in 28355. The name length 
variable for this routine (28358) is cleared. The word value іп 28356 
is moved to 28352, which is used as а counter. The main loop compares 
the device name length in 28355 to 28358 to see if it is equal; if so, 
an exit is made. The character value is checked to see if it is ἃ 
"o"; if so, the loop is exited. Otherwise, the value of 258358 is 
incremented until it equals SCLEN or a "." is reached. This loop 
allows the device name to be shortened to characters left of a ".", 
thereby eliminating device options not needed in the search. An 
example of this would be "PIO.CR.LF" becomes "PIO.". The GPL  DSRLNK 
routine is also used by the Main Device search routine as noted in 
Subsection 2.5). Once the loop is exited, the name length is checked 
to see if it is zero; if so, an error is returned. The new device 
name length is now moved from >8358 into 28355. If it is greater than 
8 characters long, an error is returned. Now the MSB of SCLEN is 
cleared (again), the ROM search pointer CRULST (>83D0) is cleared, the 
subroutine pointer at 28356 is incremented by two, and the device name 
is moved to the buffer at >834A (NBA). The word at >8356 is moved to 
28354 and now 28355 is the new device name length. Then GPLDSR is 
called via a XML ›19. 


2.5 File/Main Device access routines 


BASIC and XBASIC can access peripherals through the console File 
Managment System which utilizes Peripheral Access Blocks or PABs. The 
File Managment System and PABs are covered in Section K. Because of 
the design of the File Management System, all peripherals' main device 
routines are accessed as files via different commands (or modes) such 
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pues suchst жой з= RUUTINE 


clear GROM/ROM search 
pointer 


clear device name length 


store 204 in 2836D Coffsetd? 


XML 219: search powerup 
DSRs in ROMs and execute 


GPLDSR 
ROUTINE 


i 


db μα ο. κα K K uK K. 


ғ 


pas 


END 
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FIGURE J.2.8: POWERUP ROUTINE CODE 
DCLR @>83D0 *clear ROM search pointer 0183 
CLR 828355 *clear device name length byte 0186 
ST 0›8360, 204 *store 204 іп counter 28360 0188 
XML 219 *go to GPLDSR 0188 
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FIG. 22.9: SUBPROGRAM ACCESS ROUTINE 


Initialization: 
clear >830C, set >83eC=>8356 


П/ is the program in GROM? if 
no, jump to ROM 


GROM address setup 


| — LE r> m πι m = а s 


ROM: go to GPL DSRLNK with 
data value of 20A (subprogram 
offset) 


RTNBAD: subroutine not found, 
error 


ПКЕТМ: is 28342 zero? 


no, error, return to main 


OK, continue 


Note: 

>832C=program text or token code pointer 
»8356-subroutine pointer 

>830C=temp. variable 


= G G ч 
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FIGURE J.2.10: CALL SUBPROGRAM ROUTINE CODE 
CLR @›830С *clear 28306 temp. variable 50Е0 
DST 028356,682832С *set token code pointer = subroutine 50Е2 
pointer 
* 
CZ 8058380 *is the subprogram in GROM? ΡΟΕΡ 
Β5 6825101 *no, іп ROM, jump 50Е8 
ж 
MOVE 20001 BYTE TO 828300 FROM G@>0000(@>832C)  *GROM access 50ЕА 
INC @>830D *code 50F1 
MOVE *›830С BYTE TO V@>0320 FROM G@>0000(@>832C)* 50F3 
DST @>8356,>0320 x 50ЕА 
DADD @›832С,@›830С * 50FE 
* 
ROM CALL 066820010 *go to GPL DSRLNK 5101 
DATA »0A *with data value of >0A (entry offset 5104 
value) 
* 
BS G@>510C *error return 5105 
ж 
CZ @>8342 *good return, check for end of line 5107 
BR G@>5671 *no, error 5109 
ж 
CONT *continue 510B 


END 


t 
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as OPEN, CLOSE, DELETE, etc. The access routines are in GPL in GROM 
2; all 1/0 mode routines utilize the GPL code from >4CB9 - >4CE9 with 
three entry points: 24CB9, 24СС0, and »4CC6. Below is а list of 
. modes and their associated entry points (for console BASIC 
only): 


1/0 mode Entry point 


OPEN >p4CC6 
DELETE 4CB9 DATA 207 
CLOSE 4СС6 
RESTORE 4С89 DATA 204 
INPUT 4СС0 
LOAD 4CC6 
SAVE 4CB9 DATA 206 


[Note: The entire file access system logic is beyond the scope of 
this manual. Only the common access routines are provided.] 


Figure 2.11 is the flowchart of the files access routines from 
24589 - »4CE9. At entry point >4CB9, the opcode is recovered from the 
DATA statement following CALL G@>4CB9 апа is written to the VDP. 
Entry point 24СС0 does not assume use of the DATA statement, and 
directly calls the last routine at entry point 2»4CC6. Upon return 
from »4CC6, the subroutine may either branch to an error message, or a 
normal return. Entry point »4CC6 installs the screen offset value and 
saves the FAC. The pointer for the DSR value is recovered, and an 
offset of 20D is added to provide proper table entry into the DSR. 
Then GPL DSRLNK is called with a data value of 208. Upon completion, 
the FAC is restored, checking is done for errors, and a proper return 
is made. 

A point of interest 15 the GPL code from 24ВА1 - >4BFB. This 
section apparently is used by the console in creating PABs. 


3.0 XBASIC DSRLNK 


The XBASIC cartridge from Texas Instruments does not load DSRLNK 
when a CALL INIT is issued, and therefore it is not available when in 
the XBASIC environment. The following assembly program (provided by 
TI) demonstrates how a DSRLNK assembly program maye access the RS232 
card, print a message, and return to the XBASIC calling program. Тһе 
code and comments are provided to assist programmers in understanding 
how the console accesses DSRs; note that several routines are very 
similar to those presented in Subsection 2.0. 


5 = м Ш 
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FIG. 4.2.11: GPL DSRLNK ROUTINE 


get jump address value, put In 2836D 
clear >8.354 (name length MSB) 

get device name length, put in >8355 

clear >8358 (name length variable for 


this routine? 
put word In 028356 іп 628352 (pointer? 


LOOP: counter=counterte (2835020 


compare value of >8358 to name length 
if equal, jump to GO 


compare character at position 28352 
to 7.” (period). ΙΕ equal jump to GD 


ise, increment 28358 and Jump 


GD: is the name length zero? y 
if yes, then exi 
now replace old name length 028355 
with new 0828358 
y 


Check if length > 8 characters; IF 
SO, then exi 


clear 828354 (MSB of name length) 


clear @>83D0 (ROM search pointer) 


eren subroutine pointer 
28356 value by 


move device name to buffer at 
2834A (ΝΒΑ) 

move word 628356 to 28354; 
now »8355-name length 


go to GPLDSR 


FIGURE 9.2.12: GPL DSRLNK ROUTINE CODE 


FETCH @>836D *get jump addr. value, put in >836D 030С 
CLR 658354 *clear name length MSB O3DE 
ST @>8355,V*>8356 *get device name length, put in 28355 03E0 
CLR 828358 *clear name length variable 03Е4 
DST 828352,886 *put pointer value іп 28352 03Ε6 


LOOP DINC 058352 *counter=ccunter + 2 03Е9 
ж 


CEQ @58358,@>8355 *is name length equal? O3EB 
BS 58203ҒА *yes, jump to GO ОЗЕЕ 


CEQ V*>8352,>2E *is the current character "."? 03Ғ0 
BS 68203ҒА *yes, jump to GO 03F4 


INC 858358 *otherwise, increment 28358 03Ғ6 
BR G@>03E9 *and start again at LOOP 03Ғ8 


6 CZ 828358 *is the name length zero? ΟΞΕΑ 
BS 6820438 *yes, then exit 03ҒС 


5Т @>8355,@>8358 *replace old name length with value ОЗЕЕ 
in 28358 


CGE 6›8355,›08 *is it greater than or equal to 8? 0401 
BS 6850438 *yes, then error exit 0404 


CLR — 858354 *clear MSB of name length word 0406 
DCLR 658300 *clear ROM search pointer word 0408 
DINC @>8356 *increment subroutine pointer by 2 040B 
MOVE *28354 BYTE TO @>834A FROM V*>8356 *move new name to VDP 0400 
buffer 
DADD @>8356 ,@>8354 *move word at 28356; now >8355=name 0412 
length 


XML 219 *go to GPLDSR routine 0415 
END 
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FIG. J.2.13: MAIN DEVICEZFILES ACCESS ROUTINES 


ENTER1 


recover opcode from 'CALL 
GG»4CB9 DATA XX” 


write opcode to VDP 


CALL G8»4CC6 (go to 
ENTER3> 


install screen offset O60) 
save FAC 


get pointer for DSR from 
28304; add 20D for proper 


| ENTER? 


ENTER3 


entry point 


сай GPL DSRLNK with а 
DATA »08 


restore j; branc O 
error routine If needed 


check for errors; Р11=Р11+2; 
normal return 


FIGURE J.2.14: MAIN DEVICE/FILES ROUTINE CODE 


ЕМТІ FETCH 828356 *recover opcode from 4689 
ST ү820004(828304),828356 *calling routine (DATA 4088 

* >XX) and write to VDP 

ЕМТ2 CALL G8»4CC6 *call ENT3 routine 4CCO 
BR G@>57C3 *error return 4CC3 
RTN *normal return 4CC5 

* 

ENT3 ST ү8>000С(828304),260 *install screen offset 4СС6 
MOVE »001Ε BYTE TO V@>03CO FROM @>834A *save FAC 4CCB 
DST @›8356,@›8304 *get pointer from 28304 4С01 
DADD @>8356,>000D хааа ›00 for entry addr 4CD4 
CALL 6820010 *call GPL DSRLNK 4CD8 
DATA 208 *with a DATA 208 4CDB 
MOVE 2001E BYTE TO @>834A FROM У8203С0 *restore FAC 4CDC 
BS 6824СЕ9 *branch to error if 4СЕ2 

needed 

CLOG Ve>0005(€>8304),>E0 *check for other error 4CE4 
RTNC *return + 2 no errors 4CE9 


гт 
= 
C 
ж 
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κα * e Ae A * + * k * * Kk k k k k ΧΑ k * * k ΧΧΧ k xc k k * k АСУС 


build PAB is located at >4BA1 - >4BFB 
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* 


* 


* DSR ROUTINE FOR EXTENDED BASIC ENVIORNMENT * 
* 


KK * K k ke ke de ke ke be ke ee he k * k ας k de * he * k k κ ede k k k k ek * КУК ЖКХ 


* 


SCLEN EQU 
SCNAME EQU 
CRULST EQU 
SADDR EQU 
GPLWS EQU 
VDPRD EQU 
VDPWD EQU 
VDPWA EQU 
FLGPTR DATA 
SVGPRT DATA 
SAVCRU DATA 
SAVENT DATA 
SAVLEN DATA 
SAVPAB DATA 
SAVVER DATA 
DLNKWS DATA 


TYPE DATA 
* 

***DATA 

ж 

C100 DATA 
H20 ЕДО 

Н2000 DATA 
DECMAL TEXT 
HAA BYTE 
ж 


28355 МАМЕ LENGTH 

28356 МАМЕ BUFFER POINTER 

28300 CRU ADDR VALUE 

283D2 SAVE ADDRESS BYTE 

830 GPL WORKSPACE 

28800 ΝΡΡ READ ADDR 

»8C00 

»8C02 

0 POINTER TO FLAG BYTE IN PAB 
0 SAVE GPL RETURN 

0 *CRU ADDRESS OF PERIPHERAL 
0 *ENTRY ADDRESS OF DSR 

0 SAVE DEVICE NAME LENGTH 

0 POINTER TO DEVICE NAME IN PAB 
0 *VERSION OF DSR 
0,0,0,0,0 

0,0,0,0,0,0,0,0,0,0,0, 

100 

$ 

22000 

Γι 

>AA 


***UTILITY BLWP VECTORS 
* 


DSRLNK DATA 
* 


DLNKWS , DLENTR 


***LINK TO DSR 
ж 


DLENTR MOV 
SZCB 
MOV 
MOV 
AI 
BLWP 
MOVB 
SRL 
SETO 
LI 

LNK$LP INC 
C 
JEQ 


*R144+,R5 
@H20,R15 
@SCNAME , RO 
RO,R9 
R9,-8 
@VSBR 
R1,R3 
R3,8 

R4 
R2,NAMBUF 
RO 

R4,R3 
LNK$LN 


LINK TO DSR 


FETCH PROGRAM TYPE FOR LINK 
RESET EQUAL BIT 

FETCH POINTER INTO PAB 

SAVE POINTER 

ADJUST POINTER TO FLAG BYTE 
READ DEVICE NAME LENGTH 

STORE IT 

ΜΑΚΕ IT A ΝΟΚΡ 

INIT COUNTER 

ADDRESS OF BUFFER TO HOLD NAME 


END OF NAME? 


LNK$LN 


* 


BLWP @VSBR 

MOVB R1,*R2+ 

CB ΕΙ, ΒΡΕΓΜΑΙ. 
JNE LNK$LP 

MOV R4,R4 

JEQ LNKERR 

CI R4,7 

JGT LNKERR 

CLR @CRULST 
MOV R4,@SCLEN-1 
MOV R4,@SAVLEN 
INC R4 

A R4 , @SCNAME 
MOV @SCNAME , GSAVPAB 


*** SEARCH ROM FOR DSR 


* 


SROM 
NOROM 


NOOFF 


***SEE 
* 


NAME 1 


LWPI GPLWS 

CLR Αἵ 

LI К12,20Ғ00 
MOV R12,R12 
JEQ NOOFF 

SBZ 0 

Al R12,>0100 
CLR @CRULST 
СІ 12,2000 
JEQ NODSR 

MOV R12, @CRULST 
560 0 

LI R2,>4000 
CB *R2,@HAA 
JNE МОКОМ 

A ӨТҮРЕ ,R2 
ӘМР 5602 

MOV @SADDR,R2 
580 0 

MOV *R2,R2 
JEQ NOROM 

ΜΟΝ R2,@SADDR 
INCT R2 

Μον *R2+,R9 


IF NAME MATCHES 


MOVB @SCLEN,R5 
JEQ NAME2 

CB R5, *R2+ 
JNE 560 

SRL R5,8 

LI Во, NAMBUF 
CB *R6+,*R2+ 
JNE 560 


READ A CHARACTER 
MOVE TO NAMBUF 
A PER10D? 


IS NAME LENGTH ZERO? 
ERROR ROUTINE 
IS NAME LENGTH > 7? 
ERROR ROUTINE 


STORE NAME LENGTH FOR SEARCH 
SAVE LENGTH 

NEXT AVAILABLE POSITION 
POSITION AFTER NAME 

SAVE POINTER INTO DEVICE NAME 


USE GPLWS FOR SEARCH 


START 
ANYTHING ΤΟ TURN OFF? 


TURN ОРЕ 

NEXT ROM 

CLEAR IN CASE WE'RE FINISHED 
END OF CONSOLE ROM 

DIDN'T FIND DSR 

NEXT CRU 

TURN ON КОМ 

START AT BEGINNING 

IS IT A VALID ROM? 


GO TO FIRST POINTER 


CONTINUE WHERE WE LEFT OFF 
TURN ON AGAIN 

ZERO? 

NO PROGRAM 

REMEMBER WHERE TO GO NEXT 
GO TO ENTRY POINT > 

GET ENTRY ADDRESS 


GET LENGHT AS COUNTER 
ZERO LENGTH, NO MATCH 
LENGTH MATCH? 


MAKE WORD 
POINT TO BUFFER 
CHARACTER CORRECT? 


"Ἢ ы = "s 


.- ὦ W w BERR E M ON s 


{ 
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DEC 
JNE 
NAME2 INC 
MOV 
MOV 
MOV 
BL 
JMP 
SBZ 
LWPI 
MOV 
BLWP 
SRL 
JNE 
RTWP 


ж 


R5 

NAME1 

R1 
R1,@SAVVER 
R9 , @SAVENT 
R12, 8SAVCRU 
*R9 

560 

0 

DLNKWS 
R9,RO 
@VSBR 
R1,13 
IOERR 


***ERROR HANDL ING 


* 


NODSR LWPI 
LNKERR CLR 
IOERR SWPB 

MOVB 


DLNKWS 
R1 

R1 
R1,*R13 


SOCB @H20,R15 


RTWP 


MORE TO LOOK AT? 
NEXT VERSION FOUND 


SAVE VERSION NUMBER * CAN BE USED * 
SAVE ENTRY POINT * TO AVOID * 
SAVE CRU ADDRESS * SUBSEQUENT * 
CALL SUBROUTINE * SEARCHES * 


NOT RIGHT VERSION 

TURN OFF ROM 

SELECT DSRLNK WORKSPACE 
POINT TO FLAG BYTE IN PAB 
READ FLAG BYTE 

SAVE ERROR FLAGS 

ERROR? 


DSRLNK WORKSPACE 
CLEAR ERROR FLAGS 


STORE ERROR IN RO OF CALLER 
INDICATE AN ERROR 
RETURN TO CALLER 


TABLE J.1: DSR-RELATED RAM ADDRESSES 


Address Name 
2202Е FLGPTR 
22030 SVGPRT 
›2032 SAVCRU 
22034 SAVENT 
22036 SAVLEN 
>2038 SAVEPAB 
»203A SAVVER 


28300 - >834F 


»832C 
78336 
28342 


2834А - 283600 


2834А 
28348 
28346 
>834E 
2834Ғ 
28350 
28352 
28353 
28354 501 ΕΝ 
28356 SCNAME 


28358 - 28360 
2836Е - 28378 
28376 STATUS 


28380 - >83BF 
283С0 - >83DE 


28300 CRULST 
283D2 SADDR 


283Е0 ->83FF 


Description 

pointer to the flag in the РАВ 

GPL return address 

CRU address of the peripheral 

entry address of DSR or subprogram 

device or subprogram name length 

pointer to the device or subprogram name in PAB 
version number of the DSR 


used by BASIC and XBASIC for temporary storage; 
the following address apply to DSRs and/or PABs 
pointer to token code 

pointer to first entry in PAB list 

current character/token 


FAC (floating point accumulator) 


PAB 1/0 code 
flag/status 
data buffer address 
logical record length 
character count 
record number 
screen offset 
option length 
device length 
subroutine pointer/ 1st char after PAB in VDP 


DSR use 

misc. GPL usage 

GPL status byte, set to zero for DSR call. 
Bit 2 is cond. bit; console turns this bit 
on to indicate non-existant file. 


misc. GPL usage 


INTWS Interrupt workspace, also: 


GPLWS GPL workspace 


Wo gg E 


=a 
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Εις, 2.157 OVERALL. ACCESS 


CONSOLE | DSR 


INTERRUPT 


PDWER UP κ ο A се >XML 19]... > 
GPLDSR 

CALL TEM GPL 

SUBPRG DSRLNK 

MAIN DEV 


FILES 


FILES —! 
ACCESS 
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SECTION K: MISCELLANEOUS ACCESS NOTES 


1.0 Introduction 


As the title implies, this section covers some miscellaneous tips 
and techniques on accessing peripheral devices. Subsection 2.0 
briefly covers direct access of peripherals and their DSRS. 
Subsection 3.0 summerizes information on Peripheral Access Blocks 
(PABS), particularly as they apply to interaction with DSRs. 


2.0 Direct Access 
2.1 Memory access 


Access to the DSR or peripheral (if memory mapped) by the 
console, or access to system memory by the DSR is straightforward. 
А11 possible memory locations fall between 24000 to »5FFF for 
peripherals; it is assumed that the proper CRU manipulations have been 
performed to page in the desired peripheral into the 24000 space prior 
to access. The CRU base address should not be changed by the DSR 
until the >4000 memory space is exited unless the contents of R12 are 
saved upon entry into the DSR.. 

Data may be moved between the peripheral/DSR and the system via 
MOV and MOVB instructions. MOV will transfer a 16 bit word, while 
MOVB transfers the MSB of a 16 bit word. Some examples of these 
instructions are as follows: 


Operation Example Description 
register to register MOV R4, RO move contents of R4 into RO 
MOVB R4, RO move R4 MSB to RO MSB 
register to memory MOV R4, @>40C0 move contents of R4 into 
address >40CO апа 240(1 
MOVB R4, @>40C0 move R4 MSB to byte 24000 
register indirect MOV R4, *RO move contents of R4 to 
address given in RO 
MOVB R4, *RO move R4 MSB to MSB of 
address given in RO 
reg. auto-increment MOV R4, *Ri+ move contents of R4 into R1 
and increment R1 by two 
MOVB R4, *К1+ move R4 MSB into R1 MSB and 
increment R1 by one 
indexed memory MOV @>4033(R3), R2 move contents at address 


given in R3 plus 24033 
MOVB @>4033(R3), R2 move MSB between locations 


Other transfer modes аге possible. The Indexed Memory and 
Auto-Increment are very common, particularily with memory mapped 
devices, and VOP transfers. It is recommended that the programmer use 
labels for commonly referenced addresses. Care must be taken with 
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devices such as GROMs, which autoinrement their addresses with each 
access. 


2.2 CRU access 


Individual CRU bits may be manipulated via the SBO and SBZ 
commands. For example, if register 12 contains the base CRU address, 
21500 for example, then 


SBO 0 
would activate CRU bit 21500 to 1 or "on", Likewise, the command 
SBZ 4 


would set CRU bit 21508 to O or "off". SBO 0 and SBZ 0 are found іп 
the DSR access routines and are used to activate the peripheral device 
and its DSR ROM. Other SBO/SBZ commands can be found in the DSR 
itself that manipulate the indicator light or other functions. The 
programmer is reminded that all DSR software should clear any CRU bits 
activated when exiting the DSR (the FMS will deactivate the 0 bit). 
Most CRU bits toggle latches or flip flops which may remain active 
unless its CRU bit is cleared, causing bus contention once the DSR is 
exited. 

The command TB can be used to determine the status of a CRU bit. 
Following the previous example, if the CRU base is 21500, then 


TB >5 


would input the value (1 or 0) of CRU bit 2150A. TB works only for 
peripherals that have an active CRUIN line to the console. 

The multiple bit transfers are more involved than the single bit 
transfers. Register 12 contains the starting address of the CRU bit 
selected, and the count "n" in the instruction indicates the decimal 
number of successive bits to be transferred. For example: 


LDCR @>4351 ,4 


The command LDCR is an output operation. It transfers data from 
the memory location 24351 (example) to the 4 CRU bits, starting at the 
address that is the value of the contents of register 12. If n, the 
number of bits to be transferred, is less than 8 the address is a byte 
address. If n is 8 or more, the address represents a word address. 
If n is 0, 16 bits are transferred. If using register addressing, the 
byte addressed (for n less than 8) is the left byte of the register 
containing the data. These statements apply equally to the input 
operation STCR, which inputs n bits from the CRU device and stores 
them in the specified memory location. For example, to input 6 bits 
to the memory location addressed by the contents of register 10 would 
require 


STCR *R10,6 


=: i ασ» 
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Single bit operations are usually associated with standard DSR 
peripherals, while multiple bit CRU operations are useful for CRU-only 
peripherals, or ones with 9901 interface chips. 


2.3 Programming examples 


Some simple assembly programming examples for accessing various 
peripheral types are provided below. Note that all peripherals that 
do not use a DSR in ROM must be accessed directly by an applications 
program located in the system RAM, and cannot be accessed by the ҒМ5 
of the /4Α. 


*CRU-only 
LI R12,>0600 set CRU base for 20600 
SBO 4 turn on 20608 bit 
END SBZ 4 turn off »0608 bit 
B *R11 return 


*Non DSR peripheral 
These peripherals аге paged into the 24000 space by an 
independent applications program, and not the console. | 


LI R12,>1500 set CRU base for 21500 
SBO 0 turn on bit 0. could be any bit within assigned 
range of CRU bits | 


[program/device access] 


END SBZ 0 turn off peripheral (bit 0) à 
B *R11 return 


*DSR peripheral 

These peripherals are normally accessed by the console FMS. 
However, they can be accessed via an applications program using code 
similar to the previous example. 


*Non-CRU memory-mapped 

These devices are in the 24000 - »5FFF memory address space, but 
are paged in only when no other DSR peripheral is active. Although 
this feature is implemented in hardware (see Section C), the following 
code may be used to ensure that conflict does not occur. 


LIMI 0 disable interrupts 

LI R12,»0F00 initialize CRU counter 
LOOP АІ R12,>0100 increment by 20100 

SBZ 0 turn off DSR peripheral 
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— 


СІ R12,22000 check if at end 


JEQ END stop 
JMP LOOP continue 
END $ 


[access to device] 


В *R11 return 


3.0 Notes on PABs and File Management System 


The Peripheral Access Blocks, or PABs are used in the 
BASIC/XBASIC environment to access the peripheral main devices via the 
File Management System (FMS). The Editor/Assembler manual, section 
18, and Peripheral Technical Data Manual, section C, cover PABs and 
the FMS in great detail and contain programming examples. The 
following notes are provided to assist the developer/programmer when 
designing DSR peripherals that interface with the FMS. 


A) Consider the type of peripheral vs. its access mode. Memory 
mapped devices will utilize sequential files. Mass storage devices 
may use either sequential or relative files. Some peripherals may 
only read, and are therefore limited to the INPUT mode. The DSR must 
clearly define which 1/0 modes it will operate in, and generate error 
codes for those that it does not implement. 


B) DSRLNK is used to access the DSR in applications programs that 
bypass the FMS. XBASIC requires a routine like that in Section J. A 
DATA 28 directive after the BLWP @DSRLNK is for linkage to а main 
device routine, and >A for a low level routine. 


C) DSR detected errors should be indicated in the flag byte (1) 
of the PAB. The DSR should save the least significant 4 bits of the 
I/0 opcode byte or the most significant 5 bits of the flag byte. 


Figure K.1: PAB Flag Byte 


E E E 
|--|--|----3 BIT ERROR CODE 
It is the responsibility of the DSR to set bits 5-7 in the flag 


byte to inidicate errors that occured within the DSR. Table K.1 
defines the error codes. 


D) The DSR is responsible for updating byte 8 (screen offset) of 
the PAB when a STATUS 1/0 opcode is issued. When a STATUS (209) code 
is issued, the applications program can check on the current status of 
the peripheral. The first six bits have meaning regardless if the 
file is currently open or not. The last two bits are valid for open 
files only. Some DSRs such as the decoded CLOCK DSR in Section I do 
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not implement 
be capable of 


Error code 
000 
001 
010 
011 
100 
101 
110 
111 


Status bit 
7 


о د‎ моо оло 


the STATUS 1/0 response; it is recommended that al! DSRs 
responding to this opcode. 


TABLE K.1: ERROR CODES FOR DSRS 


Meaning 
no error or bad device name if bit 2 of 28376 is set by FMS 


device is write protected 

bad open attribute or no records in relative file 

illegal operation 

out of buffer space on the device 

attempt to read past EOF, or non existent relative record 
device error 

file error 


TABLE K.2: STATUS BIT DEFINITION 


ogical end of file; 1-ЕОҒ, cannot read more 
physical end of file; 1=end of physical media 
record type; 1=variable 0-Ғіхей 

file type; 1=program O=data 

data type; 1=BINARY/INTERNAL O=ASCII/DISPLAY 
reserved set to zero 

protect flag; 1=protected O=not protected 
non-existent file 


ч 


